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PREFACE 



In this manual you will find all the commands and statements used by ATARI® 
Microsoft BASIC. The INSTRUCTION list on the inside front cover is in alphabetical 
order with page numbers for your convenience. 

BASIC was developed at Dartmouth College by John Kemeny and Thomas Kurtz. It 
was designed to be an easy computer language to learn and use. Many additions in re- 
cent years have made BASIC a complete and useful language for skilled programmers. 

This reference manual does not teach BASIC. Those who wish to learn BASIC should 
read an introductory book. Helpful books are: Computer Programming in BASIC for 
Everyone by Dwyer and Kaufman, and Basic BASIC by James S. Coan. 
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LOADING INSTRUCTIONS 



Important: The disk-based release of ATARI® Microsoft BASIC requires that all car- 
tridges (ATARI BASIC, Assembler Editor, games, and the like) be removed from the 
front cartridge slots of your computer. You will need a blank diskette in addition to the 
ATARI Microsoft BASIC diskette on which to store programs. 

Warning: The ATARI Microsoft BASIC diskette is write-protected. Do not attempt to 
punch a notch in the corner in order to write on it. Attempting to make a read/write 
diskette out of your ATARI Microsoft BASIC diskette could destroy BASIC and void all 
warranties. 

Use the following setup procedure to load ATARI Microsoft BASIC, format a blank 
diskette, write DOS files, create MEM.SAV, and transfer CIOUSR and DIR files (see 
Quick-Reference Guide for a list of timesaving steps). 

1. Connect the ATARI 800 Home Computer to a television set and to a wall 
outlet as instructed in the operators manual. 

Note: ATARI Microsoft BASIC requires a minimum of 32K of RAM. 

2. Connect the ATARI 810™ Disk Drive to the ATARI 800 Home Computer and 
to a wall outlet as instructed in the ATARI 810 Disk Drive Operators Manual. 

3. Turn on your television set. 

4. Turn the POWER (PWR) switch to ON for Disk Drive 1 . Disk drive numbers are 
set by switches located in the back of your disk drive. Consult your A TARI 810 
Disk Drive Operators Manual for drive numbers. Turn the POWER (PWR) 
switch to ON for any other disk drives you wish to use. Two red lights (the 
BUSY light and the PWR ON light) will come on. 

5. When the BUSY light goes out on Disk Drive 1, open the drive door by press- 
ing the door handle release lever. 

6. Hold the ATARI Microsoft BASIC diskette with the label in the lower right cor- 
ner and the arrow pointing towards the disk drive. Insert the diskette into the 
disk drive and close the disk drive door. 

7. Switch the computer console POWER (PWR) to ON. ATARI Microsoft BASIC 
will load into the computer's memory automatically. 

8. Type DOS iStSTIIM . The Disk Operating System II version 2.0S will load into 
your computer's memory. 

9. Remove your ATARI Microsoft BASIC Diskette from the disk drive and insert 
a blank diskette (CX8202). 

10. Use the I DOS option to format the blank diskette. 

11. Use the H DOS option to write DOS files onto the diskette. 
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12. Use the N DOS option to create MEM. SAVE. The MEM.SAV file is used to 
save the ATARI Microsoft BASIC program in memory when you use the DOS 
command. See the ATARI Disk Operating System II Reference Manual for 
more information on MEM. SAVE. 

13. If you have two disk drives you can use the C DOS option to copy files from 
the ATARI Microsoft BASIC diskette. If you have one disk drive you must use 
the O DOS option. 

Copying files with two disk drives: 

• Put ATARI Microsoft BASIC in Drive 2. 

• Put formatted diskette in Drive 1. 

• T yp e c imm . 

• Respond to COPY- FROM, TO? by typing D2:*.*,D1:*.* 

• Turn off the computer and reload ATARI Microsoft BASIC. MEM.SAV is 
now at work. 



Copying files with one disk drive: 

• Put ATARI Microsoft BASIC in disk drive. 

• Type o em 

• Respond to NAME OF FILE TO MOVE? 

• Press since source disk is in place. 

• Insert blank as DESTINATION DISK and press ISEfflffll . 

• Repeat the O procedure with the file DIR. 

• Turn off computer and reload. ATARI Microsoft BASIC. MEM.SAV is 
now at work. 



14. Remove your newly created program storage diskette and insert the ATARI 
Microsoft BASIC diskette. Turn your computer console off and then back on 
again to reload and reinitialize BASIC. To activate the MEM.SAV file you 
must remove BASIC and insert a program storage diskette. Put your program 
storage diskette back into the disk drive and press By pressing 

with your program storage diskette in the disk drive, the 
MEM.SAV diskette file will save the correct return locations for future returns 
to BASIC. 



15. If you wish to have duplicate program storage diskettes, now is the time to 
make them since you have not yet stored any programs. Use DOS option I to 
format the duplicate storage diskette. Then use the H option to write DOS 
files. Now use the J option to duplicate the program storage diskette. 

You should now remove the ATARI Microsoft BASIC diskette and hereafter use the 
new program storage diskette(s) you have created. With a program diskette you can 
save and load the programs you write, and return to BASIC. 

Pressing a program storage diskette in the disk drive brings you back 

to BASIC with a "warm start/' which means that the variables and your program will be 
just as you left it before you typed DOS 
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QUICK-REFERENCE GUIDE 



1 . 

2 . 

3 . 

4. 

5. 

6 . 

7. 

8 . 
9. 

10 . 

11 . 

12 . 



Boot* system with ATARI Microsoft BASIC Master Diskette. 
Type DOS fSllgM . 

Remove BASIC Master Diskette. 

Format blank diskette. (DOS 2.0S) 

Write DOS files to the new diskette. 

Create MEM.SAV on the diskette. 



Copy from BASIC Master Diskette to your new diskette, CIOUSR and 
DIR. 

Turn off your system and reboot* with ATARI Microsoft BASIC. 
Insert newly created diskette into Drive 1. 



RETURN 



Type DOS 
After DUP file is loaded, press 



SYSTEM RESET 



Use your newly created program storage diskette to make duplicate 
program storage diskettes (DOS option J). 



Note: Steps 10, 11, and 12 write the correct Microsoft memory images into 
the MEM.SAV files on your Microsoft BASIC program storage diskette. 

* BASIC loads into RAM automatically (boots) when you turn on the com- 
puter. 
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MICROSOFT OVERVIEW 



WHAT IS A 
PROGRAM? 



ATARI® Microsoft BASIC is a customized and enhanced BASIC programming 
language. It was developed by Microsoft for the ATARI 800™ Home Computer, which 
uses the 6502 microprocessor and customized graphics and sound-integrated circuits. 



In the development of ATARI Microsoft BASIC, the two primary considerations were 
processing speed and compatibility with other microcomputer BASIC languages. The 
fast ATARI 800 Computer clock rate of 1.8 MHz combines with the state-of-the-art 
Microsoft design to give high microprocessor throughput speed. ATARI Microsoft 
BASIC is a superset of the existing microcomputer languages. That is, ATARI Microsoft 
BASIC combines the capabilities of other microcomputer BASIC languages with some 
unique features. New graphics features have been added to take advantage of the 
hardware-supported player-missile graphics. Sound capabilities now include the ability 
to set the length of time a sound is heard. You can renumber and merge programs easi- 
ly with Microsoft BASIC. This is a powerful language with software tools to fit a variety 
of needs. 



A program is a list of steps (statements) that you wish the computer to perform. Every 
statement stored in memory must have a line number. The lowest line number is 0 and 
the highest allowable line number is 63999. Statements are performed in line number 
order starting with the lowest numbered line. You can change the order in which the 
statements are performed by branching or jumping to other line numbers. 

Line numbers always precede statements that you want stored in memory. Because the 
statements that have line numbers wait in memory until the command RUN is given, 
they are written in what is called the deferred mode. 

To be exact, execution of a program waits until you type the word RUN and press the 
BSBl key. When ATARI Microsoft BASIC is first loaded, it is ready for you to write 
programs (deferred mode) or execute statements immediately (direct mode). 

When the computer is ready to accept input, a prompt >appears on your television 
screen. When you see the >, you can enter statements with line numbers (deferred 
mode) or statements without line numbers for immediate execution. 

Let's write a BASIC program in the deferred mode: 

> 

100 PRINT 7*7 

RUN 

49 



This single-line program does not execute immediately. The program waits to perform 
the statement until you type RUN and press Buffi . The word RUN typed without a 
line number, executes the program immediately after you press the key. 



Microsoft Overview 1 





KEYWORDS 



LINE 

CONSTRUCTION 



Keywords must be spelled out. Abbreviations are not legal syntax in ATARI Microsoft 
BASIC. 

Keywords are words the computer recognizes. Each keyword tells the computer what 
you want done. The words IF, GOSUB, INPUT, and GOTO are keywords. Keywords 
can be thought of as the verbs in the vocabulary of your computer. If you write a state- 
ment that uses a keyword the computer does not recognize, BASIC will give you an 
ERROR statement when you run the program. ATARI Microsoft BASIC does not allow 
you to use keywords as variables, but does allow you to embed keywords in the 
variable names. That is, IF and GOSUB cannot be variables, but LIFE and RGOSUB are 
allowed. A complete list of keywords is given in Appendix L. 



The form of the BASIC statement looks like this: 

Line 

Number Statement 

100 IF A< >B THEN 630 ELSE 210 

Just as there are punctuation marks in the English language, so there are quotes, com- 
mas, semicolons, and colons in BASIC. The rules of punctuation are listed in this 
manual with the keywords that require them or have them as options. Following is a 
summary of punctuation use. 

QUOTATION MARKS 

The quotation marks are used to indicate where typed characters begin and end. Just 
as we use quotes in English to mark the beginning and end of a speaker 7 s words, so it is 
with BASIC. The quote mark means that the material quoted constitutes a string 
variable or string constant; strings will be covered later in the text. For now it is enough 
to know that quotes tell the computer where to begin and end a string. The string in 
this example program will be told when to start and stop printing on the screen by 
quotes: 

Example Program: 

100 PRINT "START PRINTING ON SCREEN NOW STOP" 

RUN 

START PRINTING ON SCREEN NOW STOP 



THE COMMA 

The comma has three uses. 

• Use the comma to separate required items after a keyword. The keyword 
SOUND has five different functions in ATARI Microsoft BASIC. Each parameter 
is separated by commas. For example, SOUND 2,&79,10,8,60 means voice 2, 
pitch hexadecimal 79 (middle C), noise 10, volume 8, and duration in jiffies (1/60 
of a second) 60. Another example of the comma is the statement SETCOLOR 
4,4,10 which means register 4, pink, bright luminance. The comma tells where 
one piece of information ends and the next begins. BASIC expects to find an ex- 
act order separated by commas. 
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• Use the comma to separate optional values and variable names. You can input 
any number of variable names on a single line with an INPUT statement. The 
variable names are of your own invention. You can have as many of them as 
you like as long as you separate them with a comma. For example, INPUT 
A,B,C,D,E tells the computer to expect five values from the keyboard. 

• Use the comma to space advance to the next output field in a PRINT statement. 
When used in a PRINT statement at the end of a quoted string or between ex- 
pressions, the comma will advance printing to the next column which is a multi- 
ple of 14. For example, if X is assigned the value of 25 then the statement 10 
PRINT "YOU ARE", X, "YEARS OLD" will have the following spacing when you 
run it: 



-14 columns 



■14 columns 



YOU ARE 25 

YEARS OLD 



USE OF SEMICOLON IN PRINT STATEMENT 

The semicolon is used for PRINT statement output. The semicolon leaves one space 
after variables and constants separated by semicolons. A positive number printed with 
semicolons will have a leading blank space. Negative numbers will have a minus sign 
and no preceding blank space. For example, if X is assigned the value of 25, then the 
statement 10 PRI NT "YOU ARE";X;"YEARS OLD" will have the following spacing when 
the program is run: 

YOU ARE 25 YEARS OLD 



If X is assigned the value of -25, then the statement 10 PRINT "YOU ARE";X;"YEARS 
OLD" will have the following spacing when the program is run. 

YOU ARE-25 YEARS OLD 



If you want more than one space left before and after the 25 you must leave the space 
in the string within the quotes. Thus, 

10 PRINT "YOU ARE ";25;" YEARS OLD" 



will give the following spacing when the program is run: 
YOU ARE 25 YEARS OLD 



The semicolon can also be used to bring two PRINT statements, string constants, or 
variables together on the same line of the television screen. For example: 

100 PRINT "THE AMOUNT IS $"; 

120 AMOUNT = 20 

125 REM BOTH STRING CONSTANT AND VARIABLE 

126 REM WILL PRINT ON THE SAME LINE 
130 PRINT AMOUNT 
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THE COLON 



The colon is used to join more than one statement on a line with a single line number. 
Thus, many statements can execute under the same line number. By joining more than 
one statement on a single line, the program requires less memory. 

For example: 

10 X = 5:Y = 3:Z=X + Y:PRINT ZEND 

Many times this also helps the programmer organize the program steps. The same pro- 
gram with line numbers instead of colons uses more bytes of memory: 

10 X = 5 
20 Y = 3 
30 Z = X + Y 
40 PRINT Z 
50 END 



4 Microsoft Overview 



EDITING 



KEYBOARD 

OPERATION 



SPECIAL 

FUNCTION 

KEYS 



The ATARI 800 Computer keyboard has features that differ from those of an ordinary 
typewriter. To print lowercase letters on your television screen, press the gfgfflgfft 
key. The keyboard will now operate like a typewriter, with the key giving upper- 

case letters. Since most BASIC programs are written in uppercase, you will normally 
want to return to the uppercase mode. Press the BlSil key and hold it down while you 
press the key to return to uppercase letters. 






BREAK 




Inverse (Reverse) Video Key or ATARI logo key. Press this key to 
reverse the text on the screen (dark text on light background). 
Press key a second time to return to normal text. 

Lowercase Key. Press this key to shift the screen characters 
from uppercase (capitals) to lowercase. To restore the 
characters to uppercase , press the gglBi key and the IMgffgg 
key simultaneously. 

Escape Key. Press this key to enter a command to be entered in- 
to a program for later execution. 

Example: To clear the screen, enter: 



10 PRINT 




// 



and press ISP! . Then, whenever line 10 is executed the screen 
will be cleared. 



is also used in conjunction with other keys to print special 
graphics control characters. See the graphics in Appendix K for 
specific keys and their screen-character representations. 

Break Key. Press this key to stop your program. You may 
resume execution by typing CONT and pressing 

System Reset Key. This key is similar to ItfCTS in that it also 
stops program execution. Use this key to return the screen 
display to graphics mode 0, and to clear the screen. 
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CURSOR 

CONTROL 



g MS!glf!i Tab Key. Press and the HH § keys simultaneously to 

set a tab. To clear a tab, press the UJ- ar) d IS S 23 keys 
simultaneously. Used alone, Iggjg gf* ; advances the cursor to 
the next tab position. In deferred mode, set and clear tabs by 
adding a line number, the command PRINT, and a quotation 
mark, and pressing the key. 



Examples: 



100 PRINT "| 
200 PRINT 'I 




If tabs are not set, they default to columns 7, 15, 23, 31, and 39. 



Insert Key. Press the 



and 



keys simultaneously to 



insert a line. To insert a single character, press the 
keys simultaneously. 



and 



In addition to the special function keys, there are cursor control keys that allow im- 
KEYS mediate editing capabilities. These keys are used in conjunction with the or BE! 

keys. The keys that offer special editing features are described in the following 
paragraphs. 



Hold the control key down while pressing the arrow keys to 
produce the cursor control functions that allow you to 
move the cursor anywhere on the screen without changing 
any characters already on the screen. Other key combina- 
tions set and clear tabs, halt and restart program lists, and 
control the graphics symbols. Striking a key while pressing 
the 0Jjg2 key will produce the upper left symbol on those 
keys that have three functions. 




Moves cursor up one line without changing the program or 
display. 

Moves cursor one space to the right without disturbing the 
program or display. 

Moves cursor down one line without changing the program 
or display. 

Moves cursor one space to the left without disturbing the 
program or display. 

Inserts one character space. 

Deletes one character or space. 

Temporarily stops and restarts screen display. You can use 
KSffifl 1 while listing a program or while running a program. 

Rings buzzer. 
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Hold the key down while pressing the numeric keys to display the symbols 

shown on the upper half of those keys. 




Inserts one line. 

Deletes one line. 

Returns screen display to uppercase alphabetic characters. 

Stops program execution or program list, prints a > on the 
screen, and displays the cursor (|) underneath. 
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SINGLE- 
PRECISION REAL 
CONSTANTS 



SINGLE- 
PRECISION REAL 
VARIABLES 



CONSTANTS, VARIABLES, 

AND NAMES 



There are five types of constants in Microsoft BASIC: single-precision real, double- 
precision real, integer, string, and hexadecimal. 

FORMING A VARIABLE NAME 

In ATARI Microsoft BASIC a variable name can be up to 127 characters long. The 
allowable characters include the alphabet ABCDEFCHIJKLMNOPQRSTUVWXYZ, 

numbers 1234567890, and underscore ( ). The underscore character ( ) is a legal 

character in ATARI Microsoft BASIC. Numbers are allowed in variable names as long 
as the variable name starts with an alphabetic character. The variable name X9 is 
allowed, while 9X is not allowed. 

SPECIFYING PRECISION OF NUMERIC VARIABLES 

After you create a variable name, you can specify the precision of the variable in one 
of two ways. The variable name itself can have a variable-type identifier (none, #, %, $) 
as the last character or you can predefine the starting letter as a variable type using 
DEFSNG, DEFDBL, DEFINT, or DEFSTR. 

PREDEFINING VARIABLE PRECISION 

The advantage of predefining the variable type is that you can change all the variables 
from one type to another without having to go through your program changing all 
variable names. Changing DEFINT A to DEFDBL A, for example, changes all variables 
beginning with the letter A from integer type to double-precision type. Your other op- 
tion is to use a type tag identifier: # (double precision), % (integer), and $ (string). Tag 
identifiers are attached to the end of the variable name itself. If variables should have 
both DEF identification of type and a tag identifier (#, %, $), the tag identifier has 
precedence. 

Although DEFSNG, DEFDBL, DEFINT, and DEFSTR can be placed anywhere in a pro- 
gram, they are usually placed near the beginning. In all cases the DEF statement must 
precede the variable whose type it defines. 



Examples: 65E12, 333335, .45E8, .33E-6 

If you do not otherwise specify a constant (and it is outside the range -32768 to 32767), 
it is single-precision real. 



Examples: AMT, LENGTH, BUFFER 

If you do not declare the precision of a variable, it becomes single-precision real by 
default. Numbers stored as single precision have an accuracy of six significant figures. 
The exponential range is -38 to +38. 
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DEFSNG 



Format: DEFSNG letter, | beginning letter-ending letter | 

Examples: 100 DEFSNG K, S, A-F 
120 DEFSNG Y 

Variable names beginning with the first letters identified in DEFSNG will be single- 
precision real variables. In DEFSNG K, S, A-F, the letter range A-F means ABCDEF will 
be single precision. Variable names starting with K and S will also be single precision in 
this example. Single letters and ranges of letters must be separated by commas. 

Example Program: 

10 DEFSNG A-F 
20 COUNTER = COUNTER + 1 
30 PRINT COUNTER 
40 GOTO 20 



In the DEFSNG example program, all variable names beginning with the letter C will be 
single precision. Thus, COUNTER is single precision in this example because it starts 
with C. If counter were COUNTER# (# means double precision), it would have double 
precision even though it is defined as single precision. Keep in mind that the tag iden- 
tifier in a variable name takes precedence. 

Figure 3-1 illustrates how single-precision real numbers are represented in memory. 




BYTE 0 BYTE 1 BYTE 2 BYTE 3 



mantissa sign bit 
exponent sign bit implicit radix point 

Figure 3-1 Machine Representation of Single-Precision Real 



Examples: 45D5, 23D-6, 8888888D-11 



r i 



You can specify double-precision real in the constant by putting the letter D before the 
exponential part. Double-precision real numbers are stored in 8 bytes. Numbers are ac- 
curate to 16 decimal digits. 

Constants Variables 
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DOUBLE- 
PRECISION REAL 
CONSTANTS 



DOUBLE- 
PRECISION REAL 
VARIABLES 



DEFDBL 



INTEGER 

CONSTANTS 



INTEGER 

VARIABLES 



Examples: DBL#, X#, LG NO# 

The pound sign (#) is the identifier for double-precision real variables. A double- 
precision real variable has 8 bytes. The exponent and sign are stored in the first byte. 
The range is the same as single precision -38 to T- 38. The accuracy is 16 significant 
figures in double-precision real. The pound sign (#) identifier is placed after the variable 
name. 



Format: DEFDBL letter, | beginning letter-ending letter | 

Examples: 10 DEFDBL C-E, Z 
20 DEFDBL R 

Variable names starting with letters identified by the DEFDBL statement are double- 
precision real. In the example above CDE, Z, and R are all declared as double- 
precision. The variable name El would be a double-precision variable because the 
variable name begins with E. 

Figure 3-2 illustrates how double-precision real numbers are represented in memory. 




MANTISSA 




BYTE 0 



BYTE 1 BYTE 2 BYTE 3 BYTE 4 BYTE 5 BYTE 6 BYTE 7 



exponent 
sign bit 



mantissa sign bit 
implicit radix point 



Figure 3-2 Machine Representation of Double-Precision Variable 



Examples: 23, -9999, 709, 32000 

All numbers in ATARI Microsoft BASIC within the range -32768 to 32767 are stored as 
two bytes of binary. If an integer constant is multiplied with a single-precision real 
number, the product of the multiplication will be a single-precision real number. The 
results of mathematical operations are always stored in the higher level precision type. 



Examples: SMALLNO%, J%, COUNT% 

An integer can be identified by having a percent sign (%) as the last character in the 
variable name. An example of an integer identified by name is NO%. The 16-bit integer 
is stored as twos complement binary. 
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DEFINT 



STRING 

CONSTANTS 



STRING 

VARIABLES 
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Format: DEFINT letter, | beginning letter-ending letter 

Examples: 10 DEFINT N ; J, K-M 
20 DEFINT I 



The starting letters of variable names identified by the DEFINT statement are integers. 
Integer variables increase the speed of processing but can only accurately hold values 
between -32768 and +32767. Remember that tag identifiers have precedence. Even 
though N is defined by DEFINT as being an integer type, the pound sign appearing 
after the N identifies it as double precision. N#, N1#, NUMB# are all double precision. 

Figure 3-3 illustrates how integers are represented in memory. 



S 



BYTE 0 BYTE 1 

sign bit 

0 is positive 

1 is negative 



Figure 3-3 Machine Representation of Integer Variable 



Negative integers are stored as twos complement binary. 



Examples: "AMOUNTS", "FILL IN NAME 



String constants are always enclosed in quotes. The string constant can be any length 
up to the maximum line length (127). Strings are composed of ANY keyboard 
characters: "!#$%&&"())00KJ HGGFDS." A double-quote character ("") is also allowed. 
The double quote ("") will give you a single quote when the string is printed. 

Example of a string constant used in a print statement: 

10 PRINT "Strings and %&'$ ""things""" 

20 A$ = "STRING CONSTANTS ASSIGNED TO VARIABLE NAME" 

30 PRINT A$ 



Examples: AS, NINTS, ADDRESSS 

String-variable names end with a dollar sign $. A string variable can be assigned a string 
up to 255 characters. The double-quote ("") character is a legal ATARI Microsoft 
BASIC way of getting a single quote (") within a string. 

Examples of strings assigned to AS: 

10 AS = "a string" 

20 AS = "another ""string""" 




DEFSTR 



HEXADECIMAL 

CONSTANTS 



Format: DEFSTR letter, | beginning letter-ending letter 

Examples: 10 DEFSTR A, K-M, Z 
20 DEFSTR F, J, I, O 

A variable name can be defined as a string by declaring its starting letter in the DEFSTR 
statement. Strings can be up to the length of 255 characters. As in all variable name 
declarations, the tag identifier has precedence. A# or A% are their tag types even if 
their first letter is defined by DEFSTR. 

Example Program: 

10 DEFSTR A, M, Z 

20 A = "Employee Name AMOUNT" 

30 PRINT A 



The example program will print the heading Employee Name AMOUNT. 



Examples: &7 6 , &F3, &7B, &F3EB 

It is often easier to specify locations and machine language code in hexadecimal (base 
16) rather than decimal notation. By preceding a number with &, you declare it to be 
hexadecimal. 

To jump to the machine language routine starting at hexadecimal location C305, you 
specify A= USR(&C305,0). A = PEEK (&5A61) will assign the contents of memory loca- 
tion 5A61 hex to the variable named A. Hexadecimal is useful in representing screen 
graphics — especially player-missile graphics. 



Following is an equivalency table for decimal, hexadecimal, and binary numbers. 

TABLE 3-1 

DECIMAL, HEXADECIMAL, AND BINARY EQUIVALENTS 



Decimal 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 



Hexadecimal 

1 

2 

3 

4 

5 

6 

7 

8 
9 
A 
B 
C 
D 
E 
F 



Binary 

0001 

0010 

0011 

0100 

0101 

0110 

0111 

1000 

1001 

1010 

1011 

1100 

1101 

1110 

1111 
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NUMERIC 

EXPRESSIONS 



4 



NUMERIC 
AND STRING 
EXPRESSIONS 



RELATIONAL OPERATORS 

There is no real order of precedence for the relational operators =, < >, >, < = , 
> = . They are evaluated from left to right. 



RELATIONAL AND LOGICAL SYMBOLS 

Because the relational symbols are evaluated from left to right, you could say that 
their order of precedence is from left to right. The relational symbols =, < >, <, >, 
< = , > = have precedence over the logical operators NOT, AND, OR, and XOR. NOT 
has the highest precedence, AND ranks next, OR ranks next, and XOR ranks last. 

The relational operators are combined to form expressions. For example: A>B AND 
C<D is an expression. The greater than (>) and less than (<) symbols are considered 
first, then the AND is evaluated. If the relationship is true, a nonzero number will 
result. If the relationship is not true, then zero will be the result. Nonzero is true and 
zero is false. In an IF statement this evaluation determines what happens next. The 
ELSE or the next line number is taken when an the expression formed with operators is 
false. 



OPERATOR 



< > or > < 



< 

> 



MEANING 

Equals. This is a true use of the equal sign. It asks if 
A= B. The B is not assigned to A. 

Not Equal. Evaluates whether two expressions are 
not equal. 

Is less than. A is less than B is represented by A<B. 

Greater than. A is greater than B is represented by 
A>B. 



> = or = > 



< = or = < 



Greater than or equal to. A is greater than or equal 
to B is represented by A > = B. 

Less than or equal to. A is less than or equal to B is 
represented by < = . 
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ARITHMETIC SYMBOLS 



STRING 

EXPRESSIONS 



The arithmetic symbols are: ( ), = , A, *, /, + , - (the first dash - means negation, the last 
dash means subtraction) The arithmetic symbols can be mixed with the logical 
operators in creating expressions. The expression A/C > D*A is legal. The arithmetic 
expressions represent mathematical symbols. The * symbol represents multiplication. 
The A is used in ATARI Microsoft BASIC to mean exponent. The order of precedence 
is: 



SYMBOL 

0 



A 



/ 

+ 



MEANING 

Arithmetic within parenthesis is evaluated first. 
Equals sign. 

Negative number. This is not subtraction but a 
negative sign in front of a number. Example: -3, 
-A, -6. 

Exponent. 

Multiplication. 

Division. 

Addition. 

Subtraction. 



RELATIONAL OPERATORS IN STRINGS 

Relational operators in strings ( = , < >, <, >, < = , > = ) can accomplish useful 
tasks. Alphabetical order can quickly be achieved by an algorithm using the expression 
A$<B$. A match between names can be found by asking that A$=B$. The string 
variables are evaluated as numbers in ATASCII code and since the ATASCII is ordered 
alphabetically, the evaluation of string expressions is useful. 

SYMBOL MEANING 

A$<B$ True (nonzero) if A$ has a lower ATASCII code 

number than B$. 



Sort Example: 

100 INPUT A$,B$ 

120 IF A$ < B$ THEN 160 
1 30 C$ = A$ 

140 A$= B$ 

150 B$ = C$ 

160 PRINT A$, B$ 

170 END 
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To experiment, type any two word combinations and separate them by commas. The 
words will be sorted into alphabetical order using the example above. Thus, you will 
see that BILL comes before BILLY, and CAT comes before DOG. 



The logical operators have the following order of precedence: 

OPERATOR MEANING 

NOT Not. The 8 bits of the number are complemented. If 

it is a binary 1 it becomes a 0 after this logical 
operation. 

AND The bits of the number are logically ANDed. Exam- 
ple: A AND B. If A is 1 and B is 1 the result is 1 . If A 

is 1 and B is 0 the result is 0. If A is 0 and B is 1 the 

result is 0. If A is 0 and B is 0 the result is 0. 

OR The bits of the number are logically ORed. Exam- 

ple: A OR B. If A is 1 and B is 1 the result is 1 . If A is 
1 and B is 0 the result is 1. If A is 0 and B is 1 the 
result is 1. If A is 0 and B is 0 the result is 0. 

XOR The bits of the number are logically exclusive 

ORed. Example: A XOR B. If A is 1 and B is 1 the 
result is 0. If A is 1 and B is 0 the result is 1 . If A is 0 
and B is 1 then the result is 1 . If A is 0 and B is 0 then 
the result is 0. 



The logical operators can be used with string (A$) variables. Read Section 10 on string 
expressions. 
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COMMANDS 



In ATARI Microsoft BASIC, statements are not evaluated for syntax errors until you 
type RUN and press the IllfffffT key. 



NEW Format: NEW 

Examples: NEW 

100 IF CODE < >642 THEN NEW 



NEW clears your program to allow you to enter a new program. The NEW command 
does not destroy TIME$. All variables are cleared to zero and all strings are nulled 
when NEW is executed. 

RUN Format: RUN | // device:program name"! |optional starting line number| 

Examples: RUN 

RUN 120 

200 RUN "D:TEST.BAS" 

110 RUN 200 

RUN without a line number starts executing your program with the lowest line 
numbered statement. RUN initializes all numeric variables to zero and nulls string 
variables before executing the first statement in the program. 

RUN can be used in the deferred mode (with a line number). Refer to the program on 
the next page. It can also be used to enter a program from diskette or cassette. 
However, when RUN is used to run a program on diskette or cassette (i.e., RUN 

"D.SHAPES"), it cannot be used with (optional starting line number], which can 

only be used to run programs that are already in memory. 

Example: 200 RUN "D:TEST 

When statement line number 200 is executed, it will run the program called TEST. 
RUN can be used to run tokenized (saved with the SAVE instruction) programs only. 
RUN can be used to start executing a program at a particular line number. 

Example: RUN 250 

When RUN is executed in a program, as mentioned earlier, all numeric variables are 
set to zero and all strings are nulled. 



Commands 19 



Example Program: 



100 X = 55 
110 Y — 77 
120 A$ = "A TEST" 

130 PRINT X,Y,A$ 

140 RUN 150 

150 PRINT X,Y,A$, "Variables are 0 and String is null" 
160 END 



DOS Format: DOS 

Example: DOS 

The DOS command lets you leave BASIC and enter the DOS Menu. This makes 
available all of the DOS Menu items on programs and data stored on diskette. To 
return to ATARI Microsoft BASIC, press the key. This method of exiting 

DOS will keep your program exactly as it was before you entered DOS. 



LIST 



Format: LIST 



"device: program name" 



Examples: 100 LIST 

150 LIST "C: 

120 LIST 10-40 
100 LIST "D.GRAFX.BAS 
110 LIST 100-200 
100 LIST -300 



m-n 



LIST writes program statements currently in memory onto the television screen or 
another device. If "device:program name" is present, the program statement current- 

ly in memory is written onto the specified device. 

Legal device names include: D: (for Disk), C: (for Cassette), P: (for Printer). If you do not 
follow LIST with a device name, the screen (S:) is assumed. 

When you list programs on the screen, it is often convenient to freeze the list while it is 
scrolling. To freeze a listing, press both the 2JU) and 1 key at the same time. To con- 
tinue the listing, again press and 1 at the same time. 



With the LIST command you can list just one statement or as many as you wish. A - 
(hyphen) is used to specify the range of statements: 

LIST Lists the whole program from lowest line number to the 

highest. 

LIST n Lists only the statement n (where n is a statement 

number). 



LIST -m 



LIST n- 



LIST n-m 



Listing starts with the first statement in the program and 
stops listing with statement m. Statement m is listed. 

Listing starts with statement number n and continues to 
the last statement number in the program. 

Listing starts with n and ends with m. Both statements n 
and m are included in the listing. 
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Example: 



100 REM Example of the list 
110 REM Command 

120 PRINT "SHOWS WHICH STATEMENTS" 
130 PRINT "OR GROUP OF STATEMENTS" 
140 PRINT "GET LISTED" 



LIST 110-130 



110 REM Command 

120 PRINT "SHOWS WHICH STATEMENTS" 
130 PRINT "OR GROUP OF STATEMENTS" 



Example of LIST used in deferred mode: 

10 COUNT = 1 

20 COUNT = COUNT + 1 

30 PRINT COUNT 

40 IF COUNT < > 30 THEN 20 

50 LIST 



Use LIST to list a program on a printer. This is done in direct mode. 

LIST"P: 

Use LIST to list a program in untokenized ASCII form onto a diskette. To list to diskette 
use: 

LIST"D:name.ext 

Use LOAD when you are entering untokenized (listed) programs into your computer. 
LOAD can be used to enter programs that have been listed or saved to cassette or 
diskette. 



AUTO 



Format: AUTO |n,i| 
Examples: AUTO 200,20 
AUTO 



AUTO numbers your lines automatically. If you do not specify n,i (starting number, in- 
crement) you will get line numbers starting at 100 with an increment of 10. Use AUTO 
when you start writing a program. Type AUTO, then type a starting line number. (See 
the example on the following page.) Then type the amount you want the numbers to in- 
crease. After you start the AUTO numbering, you will automatically have a new line 
number every time you type a statement and press To stop AUTO, press 

QBby itself without typing a statement. AUTO can also be stopped by pressing the 
isfSfSET key. 
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Example Program: 
AUTO 300,20 I 



Starts numbering at 300 and increments by 
20 



300 PRINT 'THIS SHOWS HOW" 
320 PRINT "AUTO NUMBERING" 
340 PRINT "WORKS" 

360 BH 



AUTO numbering ends when you press flfR ' right after a line number. If there is an 
existing line at that number, the line will be displayed on your television screen. 



DEL Format: DEL n-m 

Examples: DEL 450 - 

DEL 250 - 350 
DEL - 250 

DEL deletes program statements currently in memory. With the DEL command you 
can delete just one statement or as many as you wish. A - (hyphen) is used to specify 
the range of statements: 



DEL n 


Deletes only the statement n (where n is a statement 
number). 


DEL -m 


Deletion starts with the first statement in the program and 
‘ stops with statement m. Statement m is deleted. 


DEL ii- 


Deletion starts with statement number n and continues to 
the last statement number in the program. 


DEL n-m 


Deletion starts with n and ends with m. Both statements n 
and m are deleted. 



Example Program: 

100 PRINT "AN EXAMPLE OF" 

120 PRINT "HOW THE DELETE" 
130 PRINT "COMMAND WORKS" 



DEL 120- nfSBRSi 

Only statement 100 is left in memory. 

LIST ISHIHIfll 

100 PRINT "AN EXAMPLE OF" 
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If you want to delete a single statement from a program, simply type the statement 
number and press 

Example Program: 

110 FOR X = 1 TO 5000: NEXT 

110 fglCTSCT 



SAVE Format: SAVE "device:program name" 

Example: SAVE "D:GAME.BAS" 

SAVE copies the program in memory onto the file named by program name. Legal 

devices are D: (for disk), C: (for cassette). For example, the command SAVE 
"D:TEMP.BAS" will save the program currently in memory onto diskette. The program 
is recorded in "tokenized" form onto tape or diskette. 

Example: 

SAVE "D:PROGRAM" 

Saves PROGRAM on diskette. 

SAVE "C: 

Saves the program on cassette. 



SAVE... LOCK Format: SAVE "device:program name" LOCK 

Example: SAVE " D: PROG RAM. EXA" LOCK 

SAVE "device:program name" LOCK saves a program onto tape or diskette and en- 

codes it so that it cannot be edited, listed, merged, examined, or modified. LOCK is 
used to prevent program tampering and theft. 



LOAD Format: LOAD "device:program name" 

Examples: LOAD "D:EXAMPLE" 

110 LOAD "C:" 

LOAD "device:program name" replaces the program in memory with the one 

located on device:. Disk drive or cassette can be specified for device:. Use LOAD "C:" 
to load data or listed cassette files. For programs that have been previously saved use 

CLOAD to increase loading speed. For diskette files, use "D.program name" for listed 

programs or saved programs. 
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CLOAD Format: CLOAD 

Examples: CLOAD 

440 CLOAD 

Use CLOAD to load a program from cassette tape into RAM for execution. When you 
enter CLOAD and press . the in-cabinet buzzer sounds. Position the tape to the 

beginning of the program, using the tape counter as a guide, and press PLAY on the 
ATARI 410™ Program Recorder. Then press the fgffffgfT key again. Specific instructions 
to CLOAD a program are contained in the ATARI 410 Program Recorder Operators 
Manual. 



CSAVE Format: CSAVE 

Examples: CSAVE 

330 CSAVE 

CSAVE saves a RAM-resident program onto cassette tape. CSAVE saves the tokenized 
(compacted) version of the program. As you enter CSAVE and press iSSSfSf . the in- 
cabinet buzzer sounds twice signaling you to press PLAY and RECORD on the Program 
Recorder. Then press llflflir - again. Do not, however, press these buttons until the tape 
has been positioned. Saving a program with this command is speedier than with 
SAVE"C:" because short inter-record gaps are used. Use SAVE"C:" with LOAD"C:" or 
CSAVE with CLOAD but do not mix these paired statements — SAVE"C:" with CLOAD 
will give you an error message. 



VERIFY Format: VERIFY "device:program name" 

Examples: VERIFY "D.BIO.BAS" 

VERIFY "C: 

VERIFY compares the program in memory with the one named by "device:pro- 
gram name". If the two programs are not identical, you get a TYPE MISMATCH ER- 

ROR. 



M E RG E Format: MERGE "device:program name" 

Examples: MERGE "D:STOCK.BAS" 

MERGE "C: 

Use MERGE to merge the program stored at "device:program name" with the pro- 

gram in memory. Only programs that have been saved using the LIST instruction to put 
them on diskette or cassette can be merged. If duplicate line numbers are en- 
countered, the line on "device:program name" will replace the one in memory. On 

the following page, you can see an example of merging programs. 

Example Program: 

100 REM THIS IS A PROGRAM 
120 REM STORED ON DISKETTE 
130 PRINT "MERGE TEST" 
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LIST "D:STOCK. BAS" 



110 REM THIS PROGRAM IS 
125 REM IN COMPUTER MEMORY 
140 PRINT "RESULT" 



MERGE "D:STOCK.BAS" 

LIST 

100 REM THIS IS A PROGRAM 
110 REM THIS PROGRAM IS 
120 REM STORED ON DISKETTE 
125 REM IN COMPUTER MEMORY 
130 PRINT "MERGE TEST" 

140 PRINT "RESULT" 



RENUM 



Format: RENUM 



m, n, i 



Example: RENUM 10,100,10 

m = TEie line number to be applied to the first renumbered statement, 
n = The first line number to be renumbered. 



= The increment between generated line numbers. 



RENUM gives new line numbers to specified lines of a program. The line number to 
be applied to the first renumbered statement is the first parameter. The first line 
number to be renumbered is the next parameter. The increment or amount of in- 
crease between numbers is the last parameter. 

The default of RENUM is 10, 0, 10. 

Renumber changes all references following GOTO, GOSUB, THEN, ON. ..GOTO, 
ON...GOSUB, and ERROR statements to reflect the new line numbers. 

Note: RENUM cannot be used to change the order of program lines. For example, 
RENUM 15, 30 would not be allowed when the program has three lines numbered 
10, 20, and 30. Numbers cannot be created higher than 63999. 



RENUM 



Renumbers the entire program. The first new line number 
will be 10. Lines will increment by 10. 



RENUM 10,100 The old program line number 100 will be renumbered 10. 

Lines increment by 10 (the default is 10). 

RENUM 800,900,20 Renumbers lines from 900 to the end of the program. Line 

900 now is 800. The increment is 20. 
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RENUM 300, 140, 20 gives number 300 to line 140 when it is encountered . The incre- 
ment is 20. 



LOCK 



UNLOCK 



KILL 



NAME. ..TO 



TRON 



BEFORE 


AFTER 


100 


100 


110 


110 


120 


120 


130 


130 


140 


300 


150 


320 


160 


340 


170 


360 



Format: LOCK "device:file name" 

Example: LOCK "D:CHECKBK" 

LOCK is the same LOCK that exists in the DOS Menu. LOCK ensures that you do not 
write over a program without first unlocking it. As a BASIC command, LOCK offers a 
measure of protection against accidental erasure. 



Format: UNLOCK "device:program name" 

Example: UNLOCK "D:GAME1 .BAS" 

The UNLOCK statement restores a file so that you can write to, delete, or rename it. 



Format: KILL "device.program name" 

Example: KILL "D:PROG1 .BAS" 

KILL deletes the named program from a device. 



Format: NAME "device:program name 1" TO "program name 2" 

Example: NAME "D:BALANCE" TO "CHECKBK" 

NAME gives a new name to "device.program name 1." The device (D1: through 

D8:) must be given for the old program, but the new program name enclosed in quotes 
is the only thing following the word TO. 



Format: TRON 
Examples: TRON 

550 TRON 

This command turns on the trace mechanism. When TRON is on, the number of each 
line encountered is displayed on your television screen before it is executed. Use 
TRON in direct or deferred mode. 
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TROFF 



Format: TROFF 
Example: 770 TROFF 



This command turns off the trace mecFianism. Use TROFF in direct or deferred mode. 



L A 



T ^ 

L A 
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STATEMENTS 



REM or ! or ' Format: REM 

Example: 10 REM THIS PROGRAM COMPUTES THE AREA OF A SPHERE 
20 LET R = 25 !Sets an initial value 
30 GOSUB 225 'GO TO COMPUTATION SUBROUTINE 
65 PRINT R:REM PRINTS RADIUS 

Format: ! and ' 

Example: 10 PRINT "EXAMPLE" !TAIL COMMENTS 
20 GOTO 10 ! USE ! and ' 

The exclamation point (!) and the accent 0 are used after a statement for comments. 
REM must start right after the line number or colon, while ! and ' do not require a 
preceding colon. 

REM, !, and ' are used to make remarks and comments about a program. REM does not 
actually execute. Although REM does use RAM memory, it is a valuable aid to reading 
and documenting a program. 



LET 



Formats: | LET | variable name = | arithmetic expression | or | string expression 

variable name = | arithmetic expression | or | string expression | 

Example: 100 LET COUNTER = 55 
120 D = 598 



LET assigns a number to a variable name. The equal sign in the LET statement means 
"assign," not "equal to" in the mathematical sense. For example, LET V = 9, assigns a 
value of 9 to a variable named V. The number on the right side of the equal sign can be 
an expression composed of many mathematical symbols and variable names. Thus, 
LET V = (X + Y-9)/(W*Z) is a legal statement. 

The word LET is optional in assignment. All that is necessary for assignment is the 
equal sign. Thus, 

100 LET THIS = NUMBER * 5 

is the same as: 



100 THIS = NUMBER * 5 
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MOVE 



STOP 



CONT 



END 



GOTO 



Format: MOVE from address, to address, no. of bytes 

Example: 20 MOVE MADDR1, MADDR2, 9 

The MOVE statement moves bytes of memory from the area of memory whose lowest 

address is given by the first numeric expression (from address) to the area whose 

lowest address is given by the second numeric expression (to address). The third 

numeric expression specifies how many bytes are to be moved. The order of move- 
ment is such that the contents of the block of data are not changed by the move. 
MOVE'S primary use is in player-missile graphics. 

Example: MOVE 55,222,5 

Five bytes with a starting low address at 55 (i.e., 55-60) will be moved to location 
222-226. 



Format: STOP 
Example: 190 STOP 

STOP is used to halt execution of a program at a place that is not the highest line 
number in the program. The STOP command prints the line number where execution 
of the program is broken. STOP is a useful debugging aid because you can use PRINT 
in the direct mode to show the value of variables at the point where execution halts. 
Also, you know that your program got as far as the STOP command. 



Format: CONT 
Example: CONT 

CONT resumes program execution from the point at which it was interrupted by either 
STOP, the key, or a program error. This instruction is often useful in debugging a 

program. A breakpoint can be set using the STOP statement. You can check variables 

at the point where execution stops by using PRINT variable name in the direct mode 

(without a line number). Then resume the program by using the CONT statement. 



Format: END 
Example: 990 END 

END halts the execution of a program and is usually the last statement in a program. 
When END terminates a program, the prompt character appears on the screen. In 
ATARI Microsoft BASIC, it is not necessary to end a program with the END statement. 



Format: GOTO line number 

Example: 10 GOTO 110 

GOTO tells which line number is executed next. Normally, statements are executed in 
order from the lowest to highest number, but GOTO changes this order. GOTO causes 
a branch in the program to the line number following GOTO. 

Example: GOTO 55 
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Since this statement does not have a line number, it starts immediate execution of the 
program in memory starting at line number 55. 



IF. ..THEN 



IF.. .THEN. 



WAIT 



100 PRINT "THIS IS A COMPUTER" 
120 GOTO 100 

RUN llfflffll 



This program will cause endless branching to line number 100. Thus, the television 
screen quickly fills up with THIS IS A COMPUTER. 



Format: IF test condition THEN goto line number or a statement 

Examples: 10 IF A = B THEN 290 

20 IF J > Y AND J <V THEN PRINT "OUT OF STATE TAX" 

If the result of an IF. ..THEN test is true, the next statement executed is goto line 

number. A test is made with the relational or mathematical operators. The test can 

be made on numbers or strings. The words GOTO after THEN are optional. If the state- 

ment test, test condition , is false, the execution goes to the next numbered line in the 

program. 

160 IF A NUMBER > ANOTHER NUMBER THEN 300 

200 PRINT "ANOTHERNUMBER IS LARGER" 

250 STOP 

300 PRINT "ANUMBER IS LARGER" 

450 END 



.ELSE Format: IF test condition THEN goto line number or statement ELSE 

goto line number or statement 

Example: 250 IF R <Y THEN 450 ELSE 200 

This is the same as IF. ..THEN except that execution passes to the ELSE clause when the 
relational or mathematical test is untrue. 



Format: WAIT address, AND mask byte, compare to byte 

Example: 330 &D40B,&FF,110 IWAIT FOR VBLANK 

WAIT stops the program until certain conditions are met. Execution waits until the 
compare to byte, when ANDed with the AND mask byte, equals the byte con- 

tained in memory location address. 

WAIT is ideal if you need to halt execution until VBLANK occurs. VBLANK occurs 
every 1/60 of a second. It consists of a number of lines below the visible scan area. You 
can make sure that your screen will not be interrupted halfway through its scan lines 
(causing the screen to blip) if you WAIT until a VBLANK occurs. This technique is used 
to animate characters as shown in Appendix C, Alternate Character Sets. See Appendix 
A for an example of the WAIT statement used to control the timing of vertical fine 
scrolling. 



Statements 31 






FOR. ..TO. ..STEP Format: FOR starting variable = starting value TO ending-value STEP |increment| 

Examples: 10 FOR X = 1 TO 500 STEP 3 
30 FOR Y = 20 TO 12 STEP -2 
20 FOR COUNTER = 1 TO 250 

The FOR/NEXT statement starts incrementing numbers by increment until end- 
ing number is reached. When the ending number is counted, execution goes to the 

statement number after the NEXT statement. 

FOR/NEXT determines how many times statements between the line numbers of the 
FOR. ..TO. ..STEP and the NEXT are executed repeatedly. If STEP is omitted, it is as- 
sumed to be 1. STEP can be a negative number or decimal fraction. 

Example Program: 

100 FOR X = 1 TO 30 
110 PRINT X, SQR(X) 

120 NEXT 



NEXT Format: NEXT (variable name| 

Examples: 30 NEXT J,l 
40 NEXT VB 
120 NEXT 

NEXT transfers execution back to the FOR. .TO line number until the TO count is up. 
NEXT does not need to be followed by a variable name in Microsoft BASIC. When 
NEXT is not followed by a variable name, the execution is transferred back to the 
nearest FOR. ..TO statement. 

Example Program: 

100 FOR X = 10 TO 100 STEP 10 
110 PRINT X 
120 NEXT 
130 END 




10 

20 

30 

40 

50 

60 

70 

80 

90 

100 



Two or more starting-variables can be combined on the same NEXT line with commas. 



L J 
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GOSUB 



RETURN 



ON.. GOTO 



Example Program: 

100 FOR X = 1 TO 20 
110 FOR Y = 1 TO 20 
120 FOR Z = 1 TO 20 
130 NEXT Z,Y,X 



SUBROUTINES 

A subroutine is a group of statements that you wish to use repeatedly in a program. 
The GOSUB statement gives execution to the group of statements. RETURN marks the 
end of the subroutine and returns execution to the statement after the GOSUB state- 
ment. 



Format: GOSUB line number 

Example: 330 GOSUB 150 

GOSUB causes line. number to be executed next. The statement starting with 

line. number is the start of a group of statements you wish to use a number of times in 

a program. 



Format: RETURN 
Example: 550 RETURN 



RETURN returns the program to the line number after the GOSUB statement which 
switched execution to this group of statements. 



Example Program: 

110 GOSUB 140 

120 PRINT "THIS IS THE END" 

130 STOP 

140 PRINT "THIS IS THE START" 

150 PRINT "OF CODE WHICH" 

160 PRINT "IS EASY TO CALL" 

170 PRINT "(EXECUTE) A NUMBER" 

180 PRINT "OF TIMES IN A" 

190 PRINT "PROGRAM" 

200 RETURN ! EXECUTION CONTROL GOES TO LINE NUMBER 120 



Format: ON arithmetic expression GOTO line number 1, line number 2, 

line number 3 

Example: 400 ON X GOTO 550, 750, 990 

ON. ..GOTO determines which line is executed next. It does this by finding the number 

represented by the arithmetic expression and if the number is a 1, control passes to 

line number 7. If the number is a 2, control passes to line number 2. If the 

number is a 3, control passes to line number 3 , etc. 
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ON. ..GOSUB 



ON ERROR 



ERROR 



Format: ON arithmetic expression GOSUB line number 1, line number 2, 

line number 3 

Example: 220 ON X GOSUB 440, 500, 700 

ON. ..GOSUB determines which line is executed next. It does this by finding the number 

represented by the arithmetic expression. If the number is a 1 then execution passes 

to line number 7. If the number is a 2, execution passes to line number 2, or If 

the number is a 3, execution passes to line number 3, etc. 

RETURN is used to transfer execution back to the statement directly after the GOSUB. 
Example Program: 

110 ON X GOSUB 333, 440, 512, 620 



333 B=B + C 
340 RETURN 



Format: ON ERROR line number 

Example: ON ERROR 550 

Program execution normally halts when an error is found and an error message prints 
on the television screen. ON ERROR traps the error and forces execution of the pro- 
gram to go to a specific line number. 

The ON ERROR line number statement must be placed before the error actually oc- 
curs in order to transfer execution to the specified line number. 

To recover normal execution of the program, you must use the RESUME statement. 
The RESUME statement transfers execution back into the program. 

When RUN, STOP, or END is executed, the ON ERROR statement is terminated. 

Example Program: 

10 ON ERROR 1000 
20 PRINT #3, "LINE" 

30 STOP 

1000 PRINT "DEVICE NOT OPENED YET" 

1010 STOP 
1020 RESUME 

The ON ERROR line number statement can be disabled by the statement: ON ER- 

ROR GOTO 0. If you disable the effect of ON ERROR within the error-handling routine 
itself, the current error will be processed in the normal way. 



Format: ERROR error code 

Example: 640 ERROR 162 

ERROR followed by an error code forces BASIC to evaluate an error of the specified 

error code type. Forcing an error to occur is a technique used to test how the pro- 

gram behaves when you make a mistake. A complete listing of error codes is given in 
Appendix M. You can force both system errors and BASIC errors. 
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ERL 



ERR 



AFTER 



CLEAR STACK 



STACK 



RESUME 



Format: ERL 

Example: 100 PRINT ERL 

ERL returns the line number of the last encountered error. 



Format: ERR 

Example: 120 PRINT ERR 

150 IF ERR = 135 THEN GOTO 350 

ERR returns the error number of the last encountered error. 



Format: AFTER (time in 1/60 of a sec) |GOTO| line number 

Example: 100 AFTER (266) GOTO 220 

When AFTER (...) is executed, a time count starts from 0 up to the number of 1/60 of a 
second (called jiffies). When the time is up, program execution transfers to 

line number. AFTER can be placed anywhere in a program but it must be executed in 

order to start its count. A time period up to 24 hours is allowed. 

When RUN, STOP, or END is executed the AFTER statement jiffie count is reset. 



Format: CLEAR STACK 
Example: 100 CLEAR STACK 

CLEAR STACK clears all current time entries. CLEAR STACK is a way to abort the 
AFTER statement. If certain conditions are met in a program, you may wish to cancel 
the AFTER statement. 

Example Program: 

100 AFTER (1333) GOTO 900 
150 IF A= B THEN CLEAR STACK 
900 PRINT "YOUR TURN IS OVER" 

910 RESUME 



Format: STACK 

Examples: 120 PRINT STACK ! Prints no. of stack entries available 
310 IF STACK = 0 THEN PRINT "STACK FULL" 

The STACK function gives the number of entries available on the time stack. The time 
stack can hold 20 jiffie entries. The STACK is used to hold the SOUND and AFTER jiffie 
times. This is a random stack since when a jiffie is up, time expires regardless of when 
the jiffies were put in the STACK. 



Formats: RESUME line number| 

RESUME NEXT| 
RESUME 

Examples: 300 RESUME 55 

440 RESUME NEXT 
450 RESUME 
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RESUME is the last statement of the ON ERROR line number error-handling routine. 

RESUME transfers control to the line number. 



OPTION BASE 



CLEAR 



COMMON 



RESUME NEXT transfers execution to the statement following the occurrence of the 
error. 

RESUME transfers execution back to the originating (error causing) line number if you 
do not follow RESUME with NEXT or line number. 



Formats: OPTION BASE 0 
OPTION BASE 1 
Example: 150 OPTION BASE 1 

200 DIM Z (25,25,25)!array element subscripts no. 1-25 

OPTION BASE 1 declares that list and array subscript numbering will start with 1 . The 
OPTION BASE (0/1) statement should be the first executable statement in a program. It 
states that you want the subscripted variables to begin with 0 or 1. If the OPTION 
BASE statement is omitted, lists' and arrays' subscript numbering starts at 0. 

Example Program: 

100 REM DEMONSTRATES OPTION BASE 1 STATEMENT 
110 OPTION BASE 1 
120 DIM ARRAY (15,15) 

150 READ ARRAY (1,1), ARRAY (2,2), ARRAY (15,15) 

165 DATA 32,33,34 

180 PRINT ARRAY (1,1), ARRAY (2,2), ARRAY (15,15) 

190 END 



Format: CLEAR 
Examples: CLEAR 

550 CLEAR 

CLEAR zeros all variables and arrays, and nulls all strings. If an array is needed after a 
CLEAR command, it must be redimensioned. 

Formats: COMMON variable name, | variable name 

COMMON ALL 

Examples: 110 COMMON I, J, A$, H%, DEC, F() 

100 COMMON ALL 



Use COMMON to keep variable values the same across program runs. COMMON 
makes variables in two programs the same variable in fact as well as in name. If you 
name a variable COUNT in one short program and join that program with another pro- 
gram that has COUNT as a variable, the program will consider the COUNTs to be dif- 
ferent variables. The COMMON statement says that you want both COUNTs to be 
considered the same variable. COMMON ALL keeps all previous variable values the 
same across the new program run. 
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Example Program: 



100 COMMON X 
110 X = 4 

120 RUN "D:PROG2 // 




print x i mam 

The value of X = 4 after line 120 calls the new program is 4. If there is already a variable 
named X in the second program, then X gets its value from the new program. 



RANDOMIZE 



Format: RANDOMIZE |seed 
Examples: 10 RANDOMIZE 

10 RANDOMIZE 55 ISets a certain 



repeatable sequence 



RANDOMIZE assures that a different random sequence of numbers will occur each 
time a program with the RND arithmetic function is run. RANDOMIZE gives a random 
seed to the starting point of the RND sequence. 



Example Program: 

100 RANDOMIZE 
110 PRINT RND 
120 END 



Each time you run the above program, a unique number prints on the television screen. 

The RND arithmetic function will repeat the same pseudo-random number each time a 
program is run without RANDOMIZE. In testing a program it is sometimes ideal to 
have an RND sequence that you know will be the same each time. In this case, use the 
RND function by itself without RANDOMIZE. Another way to produce a long se- 
quence that will be the same each time, is to use RANDOMIZE |seed| (where | seed | is 
an arbitrary number). But if you wish to see a different set of cards each time you play 
the game, just use RANDOMIZE by itself somewhere near the start of your program. 

Example of RND without RANDOMIZE: 



100 PRINT RND 
110 END 



Each time you run this program, it prints the same number on the television screen. 



OPTION PLM1, 
OPTION PLM2, 
OPTION PLM0 



Format: OPTION PLM1 
OPTION PLM2 
OPTION PLM0 
Example: 100 OPTION PLM1 
100 OPTION PLM2 
700 OPTION PLM0 
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OPTION PLM1 reserves 1280 bytes in memory for player-missiles (single-line resolu- 
tion). OPTION PLM2 reserves 640 bytes in memory for player-missiles (double-line 
resolution). OPTION PLMO releases all OPTION PLM reservations. 

The GRAPHICS instruction (see Section 12) must always precede the OPTION PLMn 
statement. This is because the computer must first know the graphics mode before you 
reserve space. 

Use OPTION PLM1 or OPTION PLM2 to reserve player-missile memory, clear the 
memory, and set PMBASE. You do not need to worry about the proper memory area to 
place player-missiles when you use the OPTION PLM statements. To find the exact 
memory location of the starting byte of your missiles, use VARPTR(PLMI) or 
VARPTR(PLM2). 

You must poke decimal location 53277 with decimal 3 in order to enable player-missile 
graphics. You must also poke decimal location 559 with decimal 62 for single-line 
resolution or decimal 46 for double-line resolution. See Section 13 for an example of 
player-missile graphics. 



OPTION CHR1, 
OPTION CHR2, 
OPTION CHRO 



Format: OPTION CHR1 
OPTION CHR2 
OPTION CHRO 
Examples: 110 OPTION CHR1 
120 OPTION CHR2 
130 OPTION CHRO 

OPTION CHR1 reserves 1024 bytes in memory for character data. OPTION CHR2 
reserves 512 bytes in memory for character data. OPTION CHRO releases all OPTION 
CHR reservations. 

Use OPTION CHR1 or OPTION CHR2 to reserve memory for a RAM character set. You 
can MOVE the ROM character set into the new RAM area you have reserved or you 
can define a totally new character set. VARPTR(CHRI) orVARPTR(CHR2) will point to 
the starting address of the zeroth character. It is necessary to POKE a new starting ad- 
dress into CHBAS. This can be done by determining the page to which VARPTR(CHRI) 
or VARPTR(CHR2) is pointing. One way to determine and POKE a new CHBAS is: 

300 CHBAS = &2F4 

310 ADDR% = VARPTR(CHRI) 

320 POKE CH BAS,((ADDR%/256) AND &FF) 

The GRAPHICS instruction (see Section 12) must always precede the OPTION CHRn 
statement. This is because the computer must first know the graphics mode before you 
reserve space. 

This procedure will mask for the Most Significant Byte (MSB) of the VARPTR memory 
address and POKE that MSB into CHBAS so you will switch to the new character set. 
See Appendix C for an example of redefining the character set. 
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OPTION 

RESERVE 



VARPTR 



Format: OPTION RESERVE n 
Example: 300 OPTION RESERVE 24 

In the OPTION RESERVE n statement, n is a number representing the number of bytes 
reserved. For example, OPTION RESERVE 24 reserves 24 bytes. VARPTR(RESERVE) 
can be used to tell you the starting address of the 24 bytes in OPTION RESERVE 24. 
This statement allows you to reserve bytes for machine code or for another purpose. 



Formats: VARPTR(variable name) 

VARPTR(PLMI) 

VARPTR(PLM2) 

VARPTR(CHRI) 

VARPTR(CHR2) 

VARPTR(RE SERVE) 

Examples: 110 A = VARPTR(A$) 

100 PRINT VARPTR(A$ + 1) 

120 J = VARPTR(TOTAL) 

120 T = VARPTR(CHR2) 

155 POKE VARPTR(RESERVE),&FE 

If the argument to this function is a variable name, the function returns the address of 
the variable's symbol table entry. When the variable is arithmetic, VARPTR returns the 
variable's 2-byte starting address (Most Significant Byte, Least Significant Byte) in 
memory. When the variable is a string, VARPTR returns the number of bytes in the 
string. Then the starting location of the string is given in VARPTR(A$) + 1 Least Signifi- 
cant Byte and VARPTR(A$)T- 2 Most Significant Byte. Notice that only in the case of 
strings is the address given in the 6502 notation of low-memory byte before the high- 
memory byte. Except in the case of strings the whole address in high byte; low-byte for- 
mat is returned with VARPTR. The following keywords can be used with VARPTR. 

VARPTR(PLMn) Returns the address (MSB, LSB) of the first byte allocated 

for PLMn. 

VARPTR(CHRn) Returns the address (MSB, LSB) of the first byte allocated 

for CHRn. 

VARPTR(RESERVE) Returns the address (MSB, LSB) of the first byte allocated 

for assembly language programs. 

Use OPTION PLM1, OPTION PLM2, OPTION CHR1, OPTION CHR2, and OPTION 
RESERVE n to allocate space. Once OPTION has been used to set aside space, 
VARPTR can be used to point to the starting byte of that space. 
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7 



PRINT 



INPUT/OUTPUT STATEMENTS 



The keyboard, disk drive, program recorder, and modem are ways your computer gets 
information — Input. The ATARI Home Computer also gives information by writing it 
on the television screen, cassette tape, printer, or diskette — Output. 

ATARI input and output devices have identifying codes: 

K: Keyboard. Input-only device. The keyboard allows the computer to get information 
directly from the typewriter keys. 

P: Line Printer. Output-only device. The line printer prints ATASCII characters, a line at 
a time. 

C: Program Recorder. Input and output device. The recorder is a read/write device that 
can be used as either, but never as both simultaneously. The cassette has two tracks 
for sound and program recording purposes. The audio track cannot be recorded from 
the ATARI Computer system, but may be played back through the television speaker. 

D1:,D2:,D3:,D4: Disk Drives. Input and output devices. If 32K of RAM is installed, the 
ATARI Computer can use four ATARI 810™ Disk Drives. The default is D1 : if no drive is 
designated. 

E: Screen Editor. Input and output device. This device uses the keyboard and television 
screen (see S: TV Monitor) to simulate a screen editing terminal. Writing to this device 
causes data to appear on the display starting at the current cursor position. Reading 
from this device activates the screen-editing process and allows the user to enter and 
edit data. Whenever the key is pressed, the entire line is selected as the current 

record to be transferred by Central Input/Output (CIO) to the user program. 

S: TV Monitor. Input and output device. This device allows the user to read characters 
from and write characters to the display, using the cursor as the screen-addressing 
mechanism. Both text and graphics operations are supported. 

R: Interface, RS-232. The ATARI 850™ Interface Module enables the ATARI Computer 
system to interface with RS-232 compatible devices such as printers, terminals, and 
plotters. 



Formats: PRINT "string constant" 

? "string constant", variable name 

PRINT variable name 1, variable name 2, variable name etc 

PRINT#iocb, AT(s,b);X,Y 

PRI NT#6, AT(x,y);"string constant";variable name 

Examples: 100 PRINT "SORTING PROGRAM";A$,X 

500 ?#6, "ENTERING DUNGEON" ! Print for GRAPHICS 1 and 2 
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PRINT puts string constants, string variables, or numeric variables on the television 
screen when executed. The PRINT statement will leave a blank line when executed 
alone. The question mark symbol (?) means the same thing as the word PRINT. 

Example Program: 

100 PRINT "SKIP A LINE" 

120 PRINT 

125 REM NOTE USE OF "" TO PRINT A QUOTE 

130 ANOTHER LINES = "PRINT ""ANOTHER"" LINE" 

140 ? ANOTHER LI N E$ 

150 END 

Line 120 leaves a blank line when this program is run: 

SKIP A LINE 

PRINT "ANOTHER" LINE 

String constants, string variables, and numeric variables will all print on the same line 
when the line construction includes a comma or semicolon. 

It is not necessary to use a closing quote if you wish to print a string constant on your 

television screen: 



100 PRINT "NO CLOSING QUOTE HERE 



RUN 



NO CLOSING QUOTE HERE 

PRINT#iocb will print at a particular sector and byte if the disk drive has been 
opened as OUTPUT (see OPEN statement). The AT clause is quite versatile. If the 
device being addressed is a disk drive, AT(s,b) refers to the sector, byte. However, if the 
device being addressed is the screen, as in PRINT or PRINT#6, then the AT(x,y) refers to 
the x,y screen position. 



An example of printing to a disk drive: 



100 OPEN#3, "D:TEST.DAT" OUTPUT 
110 X = 5 

120 PRINT#3, AT(7,1 );"TEST";X 
130 CLOSE#3 



An example of printing to a screen location: 
100 GRAPHICS 1 

110 PRINT#6, AT(3,3);"PRINTS ON SCREEN" 



TAB Format: TAB(n) 

Example: 120 PRINT TAB(5);"PRINT STARTS 5 SPACES IN" 
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TAB moves the cursor over the number of positions specified within the parentheses. 
This statement is used with PRINT to move characters over a number of tabbed 
spaces. 

Example Program: 

100 PRINT TAB (5); r/ THIS LINE IS TABBED RIGHT FIVE" 

120 END 



SPC Format: SPC(n) 

Example: 10 PRINT TAB (5); // XYZ ,/ ;SPC (7);"SEVEN SPACES RIGHT OF XYZ" 



SPC puts spaces between variables and constants in a line to be printed. The TAB 
always sets tabs from the left-hand margin. SPC counts spaces from where the last 
variable or constant ends. 



PRINT USING PRINT USING lets you format your output in many ways: 

• Numeric variable digits can be placed exactly where you want them. 

• You can insert a decimal point in dollar amounts. 

• You can place a dollar sign ($) immediately in front of the first digit of a dollar 
amount. 

• You can print a dollar sign ahead of an amount. 

• Amounts can be padded to the left with asterisks (***$45.00) for check protec- 
tion purposes. 

• Numbers can be forced into exponential (E) or double-precision (D) format. 

• A plus sign ( + ) causes output to print as a + for positive and a - for negative 
numbers. 

PRINT USING # 

The pound sign # holds a position for each digit in a number. Digits can be specified to 
the right or left of the decimal point with the pound sign #. Zeros are inserted to the 
right of the decimal, if needed, in the case where the amount is in whole dollars. 
Decimal points are automatically lined up when # is used. The # is convenient in finan- 
cial programming. 

Example Program: 

10 X = 246 

20 PRINT USING "###";X 

run mmm 

246 

If a number has more digits than the number of pound signs, then a percent sign will 
print in front of the number. 
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Example Program: 



100 X = 99999 110 PRINT USING "###"; X 
120 END 



run mmm 

% 99999 



PRINT USING . 

Place the period anywhere within the # decimal place holders. The decimal in the 
amount will align with the decimal in the USING specification. 

10 X = 2.468 20 PRINT USING // ##.## // ;X 



run Bgg 



2.47 

Note that since only two digits were specified after the decimal point, the cents posi- 
tion was rounded up. 

PRINT USING , 

Place a comma in any PRINT USING digit position. The comma symbol causes a com- 
ma to print to the left of every third digit in the result. Extra decimal position holders (#) 
must be used if more than one comma is expected in a result. 

Example Program: 

10 X# = 2933604.53 [Double precision needed this # tag 
20 PRINT USING "########,. ##";X# 

30 END 

RUN Sflff^ 

2,933,604.53 

PRINT USING ** 

Two asterisks in the first two positions fill unused spaces in the result with asterisks. 
The two asterisks count as two additional digit positions. 

Example Program: 

100 X = 259 

120 PRINT USING "**#######. ##";X 



RUN ffSIlgfgi 

***** *259 qq 
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PRINT USING $ 



A dollar sign at the starting digit position causes a dollar sign to print at the left digit 
position in the result. 

Example Program: 

100 X = 3.59631 

110 PRINT USING // $###.## // ;X 
120 END 



run m 

$ 3.60 



PRINT USING $$ 

Two dollar signs ($$) in the first two positions give a floating dollar sign in the result. 
That is, the dollar sign will be located immediately next to the first decimal digit that is 
displayed. 

Example Program: 

100 X = 3.5961 

110 PRINT USING "$$###.##";X 
120 END 




PRINT USING **$ 

If **$ is used in the first three positions the result will have asterisks filling unused posi- 
tions and a dollar sign will float to the position immediately in front of the first 
displayed digit. 

Example Program: 

100 X = 53.29 

110 PRINT USING " * * $########.##"; X 
120 END 



RUN 



RETURN 






$53.29 



PRINT USING AAAA 

Four exponentiation symbols after the pound sign (#) decimal place holder will cause 
the result to be in exponential (E or D) form. 
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Example Program: 



100 X = 500 

110 PRINT USING "## AAAA";X 
120 END 

RUN I331B5E 

5E + 02 

PRINT USING + 

The plus sign ( + ) prints a + for positive and a minus (-) for negative in front of a 
number. The plus sign ( + ) can be used at the beginning or end of the PRINT 
USING string. 

Example Program: 

100 A = 999.55 

110 PRINT USING " + ####"; A 
120 END 

RUN MWMM 

+ 1000 

PRINT USING - 

The minus (-) sign following the PRINT USING string makes a —appear following a 
negative number. A trailing space will appear if the number is positive. 



Example Program: 

1 00 A = -998 

110 PRINT USING "###-"; A 
120 END 



RUN flliflSl 

998- 

PRINT USING ! 

The exclamation sign (!) pulls the first character out of a string. 



Example Program: 

100 A$ = "B MATHEMATICS 1A" 
110 PRINT USING "!";A$ 

120 END 

RUN MWIMi 

B 
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PRINT USING %bbbb% 



INPUT 



LINE INPUT 



DATA 



The percent signs (%) and blank spaces (b) will pull part of a string out of a longer str- 
ing. The length of the string you pull out is 2 plus the number of spaces (b's) between 
the percent signs. 

Example Program: 

100 A$ = "Smith Fred" 

120 PRINT USING "%bbb%";A$ 

130 END 

RUN lEiSHBi 



Smith 



Format: INPUT|#iocb| |"prompt string" | , | AT(s,b)|; variable name, 

INPUT#6 |"prompt string" | , |AT(x,y)|; variable name 

Examples: 120 INPUT "TYPE YOUR NAME";A$ 

350 INPUT "ACCOUNT NO., NAME";NUM,B$ 

300 INPUT#5, AT(9,7);X 



variable name 



INPUT lets you communicate with a program by typing on the computer keyboard. 
You are also allowed to print character strings with the INPUT statement. This lets you 
write prompts for the user such as TYPE YOUR NAME. The typed characters are as- 
signed to the variable names when you press the ftfgffUffl key or type a comma. The IN- 
PUT statement temporarily stops the the program until keyboard INPUT is complete. 
The INPUT statement automatically puts a question mark on the television screen. 

If a disk drive has been opened as INPUT and assigned an IOCB#, then it can be used 
to input data. The input from the device is read AT(sector,byte) and assigned a variable 
name. INPUT#6, AT(x,y);X can be used to read a specific screen 
location. 



Format: LINE INPUT|#iocb| |"prompt string" | string variable name$ 

Example: 190 LINE INPUT ANS$ 

An entire line is input from the keyboard. Commas, colons, semicolons, and other 
delimiters in the line input from the keyboard are ignored. Mark the end of the line by 
pressing H3IHM or its ASCII equivalent &9B for the End of Line (EOL). 

Example Program: 

100 LINE INPUT "WHAT IS YOUR NAME?"; N$ 

120 PRINT N$ 

130 END 



Format: DATA arithmetic constant, | arithmetic 

DATA string constant, | string constant | 

Example: 140 DATA 55,793,666,94.7,55 



150 DATA ACCOUNT, AGE, """NAME 



////// 



constant 



, SOCIAL SECURITY 
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The arithmetic constants and string constants in the DATA statement are assigned 

to variable names by the READ statement. Use a comma to separate the entries that 
you wish to input with DATA/READ. More than one DATA statement can be used. The 
first DATA item is assigned the first variable name encountered in READ; the second 
DATA item is assigned the second variable name, etc. When all the items are read and 
the program tries to read data when none exists — an "out-of- data" error occurs. The 
ERR statement can be used to test for the out-of-data condition. 

If a comma is included in a string item in a data statement, then the whole string item 
must be enclosed in quotes. Otherwise, it could be mistaken as a comma used to 
separate items in the DATA statement. Quotes are not required if a string uses numeric 
values as string data. 



READ Format: READ variable name 1 , | variable name 2, 1 1 variable name etc. | 

Example: 150 READ A,B 

READ assigns numbers or strings in the DATA statement to variable names in the 
READ statement. Commas separate variable names in the READ statement and items 
in the data statement. Hence, it is all right to leave extra spaces between items because 
the comma determines the end of items. READ A, B, C looks at the first three DATA 
items. If READ A, B, C is executed again, the next three numbers of the data statement 
are assigned to A, B, C respectively. The pairing of variables and data continues until 
all the data is read. 

Example of DATA/READ: 

100 FOR J = 1 TO 3 
120 READ A$,A 
1130 PRINT A$,A 
140 NEXT J 

150 DATA FRED, 50, JACK, 20, JANE, 200 
900 PRINT "END OF DATA" 

910 END 



RESTORE 



Format: RESTORE 1 1 ine number] 

Examples: 440 RESTORE 770 
550 RESTORE 



The RESTORE statement is used if data items are to be used again in a program. That 
is, RESTORE allows use of the same DATA repeated a number of times. Without the 
RESTORE statement an out-of-data error results from the attempt to READ data a se- 



cond time. The data can be restored starting with a particular line number using the op- 
tional | line number]. 



AT Formats: PRINT#6, AT(x,y);variable name, "string constant" 

PRINT AT(x,y);variable name, "string constant" 

PRINT#iocb, AT(s,b);variable name, "string constant" 

INPUT#iocb, AT(s,b); variable name 

AT can be added to either PRINT or INPUT. The numbers following AT refer to sector, 
byte if the proper disk #iocb has been opened. (See OPEN statement below.) The televi- 
sion screen is the output device when PRINT, or PRINT#6, are encountered. When the 
screen is the device, AT(x,y) gives the coordinates for printing. 
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OPEN Format: OPEN #iocb, "device:program name" file access 

Examples: 130 OPEN #4, "K." INPUT 

100 OPEN #3, "P:" OUTPUT 
150 OPEN #4, "D:PROG.SAV" INPUT 
120 OPEN #2, "D:GRAPH1.BAS" UPDATE 
110 OPEN #5, "D.PROG.BAS" APPEND 



# Mandatory cEiaracter entered by user. 

#iocb, Input/output control block (ICOB). Choose a number 

from 1 to 7 to identify a file and its file access. You must 
have a pound sign (#) followed by an IOCB number (1-7) 
and a comma. 

"deviceiprogram name" Specifies the device and the name of the program. 

Devices are D: (disk), P: (printer), E: (screen editor), K: 
(keyboard), C: (cassette), S: (television monitor), and R: (RS- 
232-C). When you use D: your program name follows the 
colon. The name of your program can be up to eight 
characters long and have a three-character extension. Pro- 
gram names must begin with an alphabetic character. At 
the beginning of this section you will find a complete 
description of the device codes (K:, P:, C:, D:, E:, S:, R:). 

file — access Tells the type of operation: 

INPUT = input operation 

OUTPUT = output operation 

UPDATE = input and output operation 

APPEND = allows you to add onto the end of a file. 



The idea behind the OPEN statement is to identify a number (the IOCB#) with the file 
access characteristics. After the OPEN#n statement is encountered in a program, you 
can use PRINT#2, INPUT#3, NOTE#5, STATUS#2, GET#4, and PUT#4. That is, you can 
use the IOCB# as an identifier. 

The OPEN#n and PRINT#n statements now substitute for LPRINT (LINE PRINTING): 

100 OPEN#3, "P:" OUTPUT 

110 PRINT#3, "THIS IS A PRINTER TEST" 

120 CLOSE#3 

The following IOCB# identifiers have preassigned uses: 

• #0 is used for INPUT and OUTPUT to E:, the screen editor. 

• #6 is used for INPUT and OUTPUT to S:, the screen itself, in test modes 
GRAPHICS 1 and GRAPHICS 2. 



An example of the use of IOCB #6 is: 

100 GRAPHICS 2 

110 PRINT#6, AT(5,5); "SCREEN PRINT TEST" 
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lOCBs #1 through #5 (and IOCB #7) can be used freely, but the preassigned lOCBs 
should be avoided unless a program does not use them for one of the preassigned uses 
mentioned above. 



CLOSE 



NOTE 



PUT/GET 



STATUS 



Format: CLOSE #iocb 
Example: CLOSE #2 

Use CLOSE after file operations are completed. The # sign is mandatory and the 
number itself identifies the IOCB. 

# Mandatory symbol 

icob The number of a previously opened IOCB 



Format: NOTE#iocb, variable. 
Example: 120 NOTE#4, l,J 



name, 



variable. 



name 



Use NOTE to store the current diskette sector number in the first variable name and 

the current byte number within byte. This is the current read or write position in the 
specified file where the next byte to be read or written is located. 



Formats: PUT#iocb, AT(sector,byte); 

GET#iocb, AT(sector,byte); 
Examples: 100 PUT#6, ASC("A") 

200 GET#1, X 

330 GET#3, AT(8,2);J,K,L 



arithmetic expression 

variable name 



PUT and GET are opposites. PUT outputs a single byte value from 0-255 to the file 
specified by #/ocb (# is a mandatory character in both of these commands). GET reads 
1-byte values from 0-255 (using #iocb to designate the file, etc. on diskette or 
elsewhere) and then stores the byte in the variable arithmetic expression. 



Formats: STATUS (iocb number) 

STATUS ("device:program name") 

Examples: 100 A = STATUS (6) 

120 A = STATUS ("D:MICROBE.BAS") 

STATUS returns the value of the fourth byte of the iocb block (status byte). The Most 
Significant Bit (MSB) is a 1 for error conditions. A zero in the MSB indicates nonerror 
conditions. The remaining bits represent an error number. 
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TABLE 7-1 

LIST OF STATUS CODES 



EOF 



Hex 


Dec 


Meaning 


01 


001 


Operation complete (no errors) 


03 


003 


End of file (EOF) 


80 


128 


iHfm key abort 


81 


129 


IOCB already in use (OPEN) 


82 


130 


Nonexistent device 


83 


131 


Opened for write only 


84 


132 


Invalid command 


85 


133 


Device or file not open 


86 


134 


Invalid IOCB number (Y register only) 


87 


135 


Opened for read only 


88 


136 


End of file (EOF) encountered 


89 


137 


Truncated record 


8A 


138 


Device timeout (doesn't respond) 


8B 


139 


Device NAK 


8C 


140 


Serial bus input framing error 


8D 


141 


Cursor out of range 


8E 


142 


Serial bus data frame overrun error 


8F 


143 


Serial bus data frame checksum error 


90 


144 


Device-done error 


91 


145 


Bad screen mode 


92 


146 


Function not supported by handler 


93 


147 


Insufficient memory for screen mode 


A0 


160 


Disk drive number error 


A1 


161 


Too many open disk files 


A2 


162 


Disk full 


A3 


163 


Fatal disk I/O error 


A4 


164 


Internal file number mismatch 


A5 


165 


Filename error 


A6 


166 


Point data length error 


A7 


167 


File locked 


A8 


168 


Command invalid for disk 


A9 


169 


Directory full (64 files) 


AA 


170 


File not found 


AB 


171 


Point invalid 



Format: EOF(n) 

Example: 120 IF EOF(4) = 0 THEN GOTO 60 



A value of true or false will be returned indicating the detection of an end-of-file condi- 
tion on the last read of IOCB n. 
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ABOUT ARRAYS 



DIM 



ARRAYS 



You are allowed up to 10 subscripted elements in a list or array without having to use 
the dimension (DIM) statement. 

For example: 

100 AN_ARRAY(1)=55 

120 AN ARRAY(2) = 77 

130 AN ARRAY(3) = 93 

140 AN ARRAY(4) = 61 

150 FOR X = 1 TO 4 

160 PRINT AN ARRAY(X) 

170 NEXT 
180 END 



An array with more than 10 elements must be dimensioned to reserve space for it in 
RAM. 



Formats: DIM arithmetic variable name (number of elements), 

DIM string variable name$ (number of elements), 1 1 ist 

Example: 10 DIM A$ (35), TOTAMT (50) 



list 



The DIM statement tells the computer the number of elements you plan to have in an 
array. If you enter more data elements into an array than you have allowed for in a 
dimension statement, you will get an error message. 



The simplest array is the one-dimensional array. Let's say a teacher has 26 students in a 
class. He can record a numeric test score for each student by dimensioning: 

10 OPTION BASE 1 
20 DIM SCORE(26) 

30 SCORE (1)= 55 
40 SCORE (2) = 86 
50 PRINT SCORE (1), SCORE (2) 

RUN 



Notice that the OPTION BASE statement begins the array subscripting with 1, thus 
SCORE (1) stores the numeric score of the first student. OPTION BASE 0 will allow you 
to begin subscripting with the number 0. 
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ATARI Microsoft BASIC allows you to have up to 255 array dimensions. Three- 
dimensional arrays allow you to make complex calculations easily. 



Example Program: 

110 X = 20: Y = 30:Z = 25 
120 DIM BOXES(X,Y,Z) 

130 ! Without an OPTION (0/1) the OPTION BASE defaults to 0 
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FUNCTION LIBRARY 



ABS Format: ABS (expression) 

Example: ABS (-7) 

ABS returns the absolute value of a number. The sign of a number will always be 
positive after this function is executed. If the number -7 (negative 7) is evaluated with 
ABS, the result will be 7 (positive 7). 

I NT Format: I NT (arithmetic expression) 

Examples: ? I NT (5.3) prints 5 on your television screen 

? I NT (-7.6) prints -8 on your television screen 



I NT returns an integer for the arithmetic expression. I NT always rounds to the 

next lower integer. 



SGN Format: SGN (arithmetic expression) 

Example: ? SGN (-34) prints -7 on your television screen 

SGN returns the sign of the arithmetic expression enclosed in parentheses. The sign is 

+ 1 if the number within the parentheses is positive, 0 if the number is 0, or -1 if the 
number is negative. 



SQR 



Format: SQR (arithmetic expression) 

Example: ? SQR (25) prints 5 on your television screen 

SQR returns the square root of a positive arithmetic expression enclosed in paren- 
theses. If the arithmetic expression evaluated by SQR has a negative (-) sign, you will 

get an ILLEGAL QUANTITY ERROR. 



RND 



Formats: RND Returns a random single-precision value between 0 and 1. 

RND (0) Same as RND above. 

RND (integer) Returns an integer between 1 and the integer inclusive. 
Examples: ? RND Prints 6 random digits after decimal point. 

RND (37) Prints a number between and including 1 through 37. 

RND returns random numbers. RND and RND(O) return random numbers between but 
not including 0 and 1 . RND (integer) returns a positive integer between and including 1 
and the (integer). 
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LOG 



Format: LOG (arithmetic expression) 

Example: ? LOG (5) prints the natural logarithm 1.60944 

LOG returns the natural logarithm (LOG e ) of a nonnegative arithmetic expression in 

the parentheses. LOG (0) will give a FUNCTION CALL ERROR. LOG (1) is 
1.61 385904 E-10. 



EXP Format: EXP (arithmetic expression) 

Example: ? EXP (3) prints 20.0855 

EXP returns the Euler's number (e) raised to the power of the arithmetic expression 

within the parentheses. 

SIN Format: SIN (arithmetic expression) 

Example: ? SIN (1) prints the sine of 1 as .841471 radian 

SIN returns the trigonometric sine of the arithmetic expression. 



COS Format: COS (arithmetic expression) 

Example: ? COS (.95) prints cosine of .95 as .581683 radian 

COS returns the trigonometric cosine of the arithmetic expression. 

ATN Format: ATN (arithmetic expression) 

Example: ? ATN (.66) prints arctangent of .66 as .583373 radian 

ATN returns the arctangent of the arithmetic-expression. 



TAN Format: TAN (arithmetic expression) 

Example: ? TAN (.22) prints the tangent of .22 as .223619 radian 

TAN returns the trigonometric tangent of the arithmetic expression. 



SPECIAL-PURPOSE FUNCTIONS 



PEEK Format: PEEK (address) 

Examples: 110 PRINT PEEK(1034) 
135 PRINT PEEK(ADDR) 



PEEK (&FFF) looks at the address enclosed in the parentheses, in this case FFF hex- 
adecimal. PEEK is used to discover the contents of a particular memory byte. You can 
examine ROM memory as well as RAM memory. All memory can be looked at with the 
PEEK instruction. 



k A 



56 Function Library 



Examples: 



PRINT PEEK(888) 

Prints the byte in decimal at decimal memory location 888. 
PRINT PEEK (&FFFF) 

Prints the byte in decimal at memory location FFFF hex. 



POKE Format: POKE address, byte 

Examples: POKE 2598,255 

110 POKE ADDR3,&FF 
120 POKE PLACE, J 

POKE inserts a byte into an address location. The address and byte can be expressed as 
decimal or hexadecimal numbers. The address and byte can also be expressions. Thus, 
if X*Y-2 evaluates to a valid memory location or byte, it can be used. 

Example: 

POKE &FFF,43 

Puts decimal 43 into hexadecimal location FFF. 



X = 22 
Y = &8F 

POKE X,Y 

Puts hexadecimal 8F into memory location 22 decimal. 

Note that decimal and hexadecimal are just two ways of assigning a number to the 
8-bit byte. The highest number you are allowed to POKE, a byte, is FF in hexadecimal 
and 255 in decimal. 



FRE (0) Format: FRE (0) 

Example: PRINT FRE(O) 

This function gives you the number of RAM bytes that are free and available for your 
use. Its primary use is in direct mode with a dummy variable (0) to inform the program- 
mer how much memory space remains for completion of a program. Of course FRE 
can also be used within a BASIC program in deferred mode. Using FRE (0) will release 
string memory locations that are not in use. This use of FRE (0) to pick up the string 
clutter is referred to as "garbage collection." 
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USR 



Format: USR (address, nl) 
Example: 550 A=USR(898,0) 



USR passes the result of a machine language subroutine to a variable name. The USR 
function branches to a machine language routine address and can pass an optional 
value, nl. The value of nl is usually the address of a data table used in the machine 
language routine. 

During the execution of a USR routine, the programmer may use page zero RAM from 
&CD through &FF. The parameter passed will be stored in &E9 and &EA as data, and in 
&E3 and &E4 as an address. The parameter is assumed to be an integer or VARPTR. 



Example Program: 

10 ! ROUTINE TO TEST USR FUNCTION 
20 ! THE ASSEMBLY ROUTINE IS: 

30 ! 

40 ! LDA #35 
50 ! STA 710 
60 ! RTS 
70 ! 

80 ! 

90 ! 

100 A = 0: 1 = 0:COL = 0:C = 0 
110 OPTION RESERVE 10 

120 ADDR = VARPTR(RE SERVE) STARTING ADDRESS 

130 FOR 1=0 TO 5 

140 READ A 

150 POKE ADDR + I, A 

160 NEXT I 

170 DATA &A9,&23,&8D,&C6,&02,&60 
180 A=USR(ADDR,VARPTR(I)) 

190 STOP 



TIME Format: TIME 

Example: 200 PRINT TIME 

TIME gives the Real-Time Clock (RTCLOK) locations' contents. The decimal locations 
18, 19, and 20 (RTCLOK) keep the system time in jiffies (1/60 of a second). Six decimal 
digits are returned by TIME. The difference between TIMES and TIME is that TIMES 
gives the time in standard hours, minutes, and seconds, while TIME gives the time as a 
jiffie count. 



58 Function Library 



10 



+ 

(Concatenation 

Operator) 



MID$ 



LEFTS 



STRINGS 



Format: string + string 
Example: 110 C$ = A$ + B$ 

Use the + symbol to bring two strings together. 

Example Program: 

110 A$ = "never" 

120 B$ = "more" 

130 Z$ = A$+B$ 

140 PRINT Z$ 

run mmm 



nevermore 



Format: Ml D$(string expression $, start, n) 

Example: 100 A$ = "GETTHEMIDDLE" 

110 PRINT MID(A$,4,3) 

string expression $ String that will have characters pulled from its middle. 

start The character you wish to start with — counting from the 

left. 

n Number of characters you want to pull. 



The string is identified by the first parameter of the function. The second parameter 
tells the starting character. The third parameter tells how many characters you want. 

Example Program: 

110 A$ = "AMOUNT OF INTEREST PAID" 

120 B$ = MID$(A$ / 11 / 8)! THIS CAUSES "INTEREST" TO BE PRINTED 
130 PRINT B$ 



Format: LEFT$(string expression $,n) 

Example: 100 A$ = "TOTALAMOUNT" 

110 PRINT LEFT$(A$,5) 

string expression $ String variable name or string expression. 

n Number of characters you want returned from the left 

side of the string. 
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RIGHTS 



LEN 



ASC 



VAL 



CHRS 



Format: RIGHT$(string expression $,n) 

Example: A$ = "THERIGHT" 

110 PRINT RICHT$(A$,5) 

string expression $ String variable name or string expression. 

n Number of characters to be taken from right side of the 

string. 



Format: LEN (string expression $) 

Example: 100 A$ = // COUNT THE" 

120 ? LEN (A$ + " CHARACTERS")!prints total number of 
130 ! characters as 20 

LEN returns the total number of characters in a string expression $. LEN stands for 

length. Spaces, numbers, and special symbols count as characters. 



Format: ASC (string expression $) 

Example: ? ASCC'Smith")! prints 83 ATASCII decimal code for letter S 

ASC gives the ATASCII code in decimal for the first character of the string enclosed in 
parentheses. See Appendix K for ATASCII Character Set. 



Format: VAL (numeric string expression $) 

Example: 100 B$ = "309" 

120 ? VAL (B$)! prints the number 309 
130 END 

VAL converts strings to numeric values. VAL returns the numeric value of the numeric 

constant associated with the numeric string expression in the parentheses. Leading 

and trailing spaces are ignored. Digits up to the first nonnumeric character will be con- 
verted. For example, PRINT VAL( // 123ABC // ) prints 123. If the first character of the string 
expression is nonnumeric, then the value returned will be 0 (zero). 



Format: CHR$ (ATASCII code number) 

Examples: 110 PRINT CHR$ (123) Iprints ATASCII club symbol 

100PRINT CHR$(65) IPRINTS ATASCII CHARACTER A 

CHR$ converts ATASCII values into one-character strings. CHR$ is the opposite of the 
ASC function. The A T ASCII code number can be any number from 0 to 255. Appen- 
dix K gives a table of both the character set and the ATASCII code numbers. 
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INSTR 



STR$ 



STRINGS (N,A$) 



STRINGS (N,M) 



INKEYS 



Format: INSTR (start, AS, B$) 

Example: 110 HOLD = INSTR(5,C$,B$) 

INSTR searches for a small string B$ within a larger string A$. The search can begin 
(start) a number of characters into the larger string. This starting position is assumed to 
be the first character if start is missing. The function returns the character position 
within A$, where B$ starts, or returns a 0 if B$ is not found. 



Format: STR$ (arithmetic expression) 

Example: 100 A = 999.02 

110 PRINT STR$(A) 

STR$ turns an arithmetic expression into a string. String operations can be carried out 

on arithmetic expressions with the STR$ function. Note that when the following two 

strings are brought together with the concatenation symbol, there is a space between 
them which represents the sign of the number. 

Example Program: 

100 NUM1 =-22.344 
120 NMU2 = 43.2 

130 PRINT STR$ (NUM1) + STR$ (NUM2) 

140 END 



Format: STRINGS (N,A$) 

Example: 100 A$ = STRING$(20,"*") 

STRING$(N,A$) returns a string composed of N repetitions of A$. 



Format: STRINGS (N,M) 

Example: 110 PRINT STRINGS(20,1 23)! prints 20 clubs 
STRING$(N,M) returns a string composed for N repetitions of CHRS(M). 



Format: INKEYS 
Example: 110 AS = INKEYS 

INKEYS records the last key pressed. If no keys are currently being pressed on the 
keyboard, a null string is recorded. Statement 110 tests for a null string by representing 
it as two double quotes with no space between them. ATARI Microsoft BASIC does not 
recognize the space bar since leading and trailing blanks are trimmed for INKEYS. 

Example Program: 

100 A$= INKEYS 

110 IF AS < >"" THEN PRINT "You typed a AS 
120 GOTO 100 
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TIMES Format: TIME$ 

Example: 100 PRINT TIME$ 

Set the time with the deferred mode statement: 

190 TIMES = "HH:MM:SS" 

where HH = hours (up to 24) 

MM = minutes 
SS = seconds 

Examples: 110 TIMES = "22:55:05" 

120 TIMES = "05:30:09" 

Note: Use leading zeros to make hours, minutes, and seconds into 2-digit numbers. 

After TIMES is set, you can use it in a program. TIMES is continually updated to the 
current time, from your initial setting. 

100 GRAPHICS 2 
110 TIMES = ,/ 11:59:05 ,/ 

120 PRINT#6, AT(3,3);"DIGITAL CLOCK" 

130 PRINT#6, AT(4,4);TIME$ 

140 GOTO 120 

SCRNS Format: SCRN$(x,y) 

Example: 10 ? SCRN$(5,5) 

The character at the X-coordinate and Y-coordinate is returned as the value of the func- 
tion in character-graphics modes. In other graphics modes, SCRNS returns the color 
register number being used by the pixel at location x,y. 

Example of SCRNS(x,y): 

10 GRAPHICS 1 
20 COLOR 1 
30 PRINT#6, AT(5,5);"A" 

40 AS = SCRN$(5,5) 

50 PRINT TAB(9);AS 
60 END 
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USER-DEFINED FUNCTION 



DEF Format: DEF function name (variable, variable) = function definition 

Example: 150 DEF MULT(J,K) = J*K 

User-defined functions in the form DEF A(X) = XA2, where A(X) represents the value of 
X, squared can be used throughout a program as if they were part of the BASIC 
language itself. Normally a user-defined function will be placed at the beginning of a 
program. The user-defined function can occupy no more than a single program line. 

String-defined functions are allowed. If the defined function is a string variable 

name, then the defined expression must evaluate to a string result. One or more 
parameters can be defined. Thus, DEF S$(A$,B$) = A$T-B$ is legal. 

Example Program: 

100 DEF AVG(X,Y) = (X + Y)/2 
120 PRINT AVG(25,35) 

130 END 

r un WSMM 

30 



DEF 63 




12 



GRAPHICS 

OVERVIEW 



GRAPHICS 



GRAPHICS 



The GRAPHICS command selects one of nine graphics modes. Graphics modes are 
numbered 0 through 8. The arithmetic expression following GRAPHICS must evaluate 
to a positive integer. Graphics mode 0 is a full-screen text mode. ATARI Microsoft 
BASIC defaults to GRAPHICS 0. 

GRAPHICS 1 through 8 are split-screen modes. In the split-screen modes a 4-line text 
window is at the bottom of the television screen. The text window is actually 4 lines of 
GRAPHICS 0 mixed into the mode. 

GRAPHICS 0, GRAPHICS 1, and GRAPHICS 2 display text and special characters of 
gradually increasing size. GRAPHICS 0 is regular text with special characters. 
GRAPHICS 1 is double-wide text and special characters. GRAPHICS 2 is double-wide, 
double-high text, and special characters. Note the keyboard representation of the text 
and special characters as an insert to this manual. The special characters that are not 
printed on your keyboard are called control characters because you must press the 
iSBEP key to have them display on the television screen. 

GRAPHICS 3 through GRAPHICS 8 are modes that plot points directly onto your 
television screen. The graphics mode dictates the size of the plot points and the 
number of playfield colors you can use. The maximum number of playfield colors in 
the point-plotting modes is four. But it is possible to get four more colors on your 
television screen by using players and missiles. For information on player-missile 
graphics, see Section 13. 



Format: GRAPHICS arithmetic expression 

Examples: GRAPHICS 2 

100 GRAPHICS 5 + 16 
110 GRAPHICS 1+32 + 16 
120 GRAPHICS 8 
130 GRAPHICS 0 
140 GRAPHICS 18 

Use GRAPHICS to select one of nine graphics modes (0 through 8). Table 12-2 sum- 
marizes the nine modes and characteristics of each. GRAPHICS 0 is a full-screen text 
display. Characters can be printed in GRAPHICS 0 by using the PRINT statement 
without an IOCB# following the keyword PRINT. GRAPHICS 1 through GRAPHICS 8 
are split-screen modes. These split-screen modes actually mix four lines of GRAPHICS 
0 at the bottom of the television screen. This text window uses the PRINT statement. 
To print in the large graphics window in GRAPHICS 1 and GRAPHICS 2, use PRINT# 6, . 
The following program will print in the graphics window in GRAPHICS 1 or GRAPHICS 
2 : 



100 GRAPHICS 1 

110 PRINT#6, AT(3,3);"GRAPHICS WINDOW TEST" 
120 PRINT "TEXT WINDOW" 

130 END 
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Adding +16 to GRAPHICS 1 through GRAPHICS 8 will override the text window and 
make a full screen graphics mode. If you run the following program without line 140, 
the screen will return to graphics mode 0. The screen returns to graphics mode 0 when 
STOP or END terminate the full screen graphics mode. 

110 GRAPHICS 2 + 16 

120 PRINT#6, AT(3,3); ,r WHOLE SCREEN IS" 

130 PRINT#6, AT(4,4);"GRAPHICS 2" 

140 GOTO 140 

Normally the screen will be cleared of all previous graphics characters when a 
GRAPHICS n statement is encountered. Adding +32 prevents the graphics command 
from clearing the screen. 

Graphics modes 3 through 8 are point-plotting modes. To draw point graphics you 
need to use the COLOR n and PLOT statements. Use of the SETCOLOR statement will 
allow you to change the default colors to any one of 128 different color/luminance 
combinations. Point-plotting modes are explored in the example at the end of this sec- 
tion. 

To return to GRAPHICS 0 in direct mode, type GRAPHICS 0 and press the BBSd key. 



COLOR Format: COLOR n 

Example: 100 COLOR 4 

COLOR is paired with SETCOLOR to write up to four colors, called playfields, on the 
television screen. You must have a COLOR statement in GRAPHICS 3, 4, 5, 6, 7, and 8 
in order to plot a color. When you use the COLOR statement without a SETCOLOR 
command you will get the default colors. For example, using Table 12-1, the default 
colors for GRAPHICS 3 are: SETCOLOR 4 is orange, SETCOLOR 5 is light green, SET- 
COLOR 6 is dark blue, and SETCOLOR 8 is black. 

Shown below are the SETCOLOR - COLOR pairings by graphics mode: 

GRAPHICS 3, 5, 7 

SETCOLOR 4,hue,lum goes with COLOR 1 
SETCOLOR 5,hue,lum goes with COLOR 2 
SETCOLOR 6,hue,lum goes with COLOR 3 
SETCOLOR 8,hue,lum goes with COLOR 0 



GRAPHICS 4, 6 

SETCOLOR 4,hue,lum goes with COLOR 1 
SETCOLOR 8,hue,lum goes with COLOR 0 

GRAPHICS 8 

SETCOLOR 5,hue,lum goes with COLOR 1 
SETCOLOR 6,hue,lum goes with COLOR 2 

Note: You must always have a COLOR statement to plot a playfield point, but SET- 
COLOR is only necessary to make a color other than a default color. 
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SETCOLOR 



Format: SETCOLOR register, hue, luminance 
Example: 330 SETCOLOR 5,4,10 



The SETCOLOR statement associates a color and luminance with a register. 



register 



hue 

luminance 



Color registers 0,1 ,2,3 are for player-missiles 0,1 ,2,3 
respectively. Color registers 4, 5,6, 7 are for playfield colors 
assignments. Register 8 is always the background register. 

Color hue number 0-15. (See table below.) 

Color luminance (must be an even number between 0 and 
14; the higher the number, the brighter the display; 14 is 
almost pure white). 



TABLE 12-1 

THE ATARI HUE (SETCOLOR COMMAND) NUMBERS AND COLORS 



Colors 


SETCOLOR Hue 
Number Decimal 


SETCOLOR Hue 
Number Hex 


Gray 


0 


0 


Light orange (gold) 


1 


1 


Orange 


2 


2 


Red-orange 


3 


3 


Pink 


4 


4 


Purple 


5 


5 


Purple-blue 


6 


6 


Azure blue 


7 


7 


Sky blue 


8 


8 


Light blue 


9 


9 


Turquoise 


10 


A 


Green-blue 


11 


B 


Green 


12 


C 


Yellow-green 


13 


D 


Orange-green 


14 


E 


Light orange 


15 


F 
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PLOT 



Formats: PLOT X,Y 

PLOT X,Y TO PLOT X,Y 
Examples: 100 PLOT 12,9 

112 PLOT 6,9 TO 3,3 

Use PLOT to draw single-point plots, lines, and outline objects on the television screen. 
PLOT uses an X-Y coordinate system for specifying individual plot points. Give a 
number from 0 to whatever the maximum is for the current mode, X first then Y. 

0,0 , ► X 



t 

Y 

You can "chain" the PLOT instruction. That is, one plot point can be made to draw to 
the next plot point. The result of chaining two PLOT points is a straight line. It is also 
easy to outline an object using chained plots. To chain plots, use the word TO between 
PLOT X,Y's. 

Example: 90 COLOR 1 !You must use a COLOR instruction before PLOT 
100 PLOT 5,5 TO 5,15 ! Draws a straight line 
120 PLOT 5,5 TO 12,12 TO 2,12 TO 5,5 !Draws triangle outline 



Here is an example program which shows PLOT, COLOR, and SETCOLOR at work: 

100 GRAPHICS 3 + 16 !THE 16 GETS RID OF TEXT WINDOW 
110 SETCOLOR 5,4,8 IPINK 
120 SETCOLOR 6,0,4 IGRAY 
130 SETCOLOR 8,8,6 ! BLUE 

140 COLOR 1 ICOLOR 1 GOES WITH DEFAULT ORANGE 

150 PLOT 5,5 TO 10,5 TO 10,10 TO 5,10 TO 5,5 ! IN ORANGE 

160 COLOR 2 ! PINK 

170 PLOT 7,7 TO 12,12 TO 2,12 TO 7,7 

180 COLOR 3 IGRAY 

190 PLOT 2,7 TO 12,7 

200 GOTO 200 



FILL Format: FILL x,y TO x,y 

Example: 550 FILL 10,10 TO 5,5 

FILL fills an area with the color specified by the COLOR and SETCOLOR statements. 
The FILL process sweeps across the television screen from left to right. FILL stops paint- 
ing and starts its next sweep when it bumps into a PLOT line or point. The line on the 
left-hand side of a filled object is specified by the FILL statement itself. 

An example will show how FILL operates. First the outline of three sides of a box are 
specified. PLOT 5,5 TO 20,5 TO 20,20 TO 5,20 makes the top, right side, and bottom of 
the box. Make the left side and FILL with the statement FILL 5,5 TO 5,20. 
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Example: 



5, 5 . j * 



5 , 20 1 1 20 , 20 

The top, right, and bottom of the box (dashed lines) is formed with PLOT 5,5 TO 20,5 
TO 20,20 TO 5,20. The box is filled with the statement FILL 5,5 TO 5,20. 

10 GRAPHICS 5 

20 SETCOLOR 4,12,8 ! Register 4, green, medium brightness 
30 COLOR 1 1COLOR 1 is paired with SETCOLOR 4 in GRAPHICS 5 
40 PLOT 5,5 TO 20,5 TO 20,20 TO 5,20 
50 FILL 5,5 TO 5,20 
60 END 

It is worthwhile to carefully review the FILL process. Line 40 in the above example 
makes three sides of a box. Then the FILL statement, line 50 draws the left side and fills 
the box. The FILL process scans from the FILL line to the right until it reaches the PLOT 
lines. 



CLS Format: CLS | background register option | 

Example: CLS 

110 CLS 

220 GRAPHICS 3: CLS &C5 
330 CLS 25 

CLS clears screen text areas and sets the background color register to the indicated 
value, if present. In GRAPHICS 0 and GRAPHICS 8 the optional number after CLS 
determines the border color and luminance. In GRAPHICS 1, 2, 3, 4, 5, 6, 7 the optional 
number following CLS determines the background color and luminance. 



TABLE 12-2 

GRAPHICS MODES AND SCREEN FORMATS 



Graphics 

Mode 


Mode 

Type 


Columns 


0 


TEXT 


40 


1 


TEXT 


20 


2 


TEXT 


20 


3 


GRAPHICS 


40 


4 


GRAPHICS 


80 


5 


GRAPHICS 


80 


6 


GRAPHICS 


160 


7 


GRAPHICS 


160 


8 


GRAPHICS 


320 



ROWS- 

Split 

Screen 


ROWS- 

Full 

Screen 


Number 

of 

Colors 


RAM 

Required 

(Bytes) 


- 


24 


2 


992 


20 


24 


5 


674 


10 


12 


5 


424 


20 


24 


4 


434 


40 


48 


2 


694 


40 


48 


4 


1174 


80 


96 


2 


21 74 


80 


96 


4 


4198 


160 


192 


y 2 


8112 
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TABLE 12-3 

CHARACTERS IN GRAPHICS MODE 1 AND 2 



POKE 

756,224 




POKE SETCOLOR SETCOLOR SETCOLOR SETCOLOR 

756,226 4 5 6 7 



□ 


32 


0 


160 


128 


n 


33 


1 


161 


129 


n 


34 


2 


162 


130 


□ 


35 


3 


163 


131 


□ 


36 


4 


164 


132 


□ 


37 


5 


165 


133 


Q 


38 


6 


166 


134 


□ 


39 


7 


167 


135 


E 


40 


8 


168 


136 


B 


41 


9 


169 


137 


H 


42 


10 


170 


138 


E 


43 


11 


171 


139 


B 


44 


12 


172 


140 


Q 


45 


13 


173 


141 


H 


46 


14 


174 


142 


a 


47 


15 


175 


143 


H 


48 


16 


176 


144 


□ 


49 


17 


177 


145 


□ 


50 


18 


178 


146 


□ 


51 


19 


179 


147 


□ 


52 


20 


180 


148 


□ 


53 


21 


181 


149 


a 


54 


22 


182 


150 


□ 


55 


23 


183 


151 












□ 


56 


24 


184 


152 


a 


57 


25 


185 


153 


□ 


58 


26 


186 


154 


□ 


59 


27 


187 


155 


□ 


60 


28 


188 


156 


a 


61 


29 


189 


167 


□ 


62 


30 


190 


168 
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63 


31 


191 


169 


64 


96 


192 


224 


65 


97 


193 


225 


66 


98 


194 


226 


67 


99 


195 


227 


68 


100 


196 


228 


69 


101 


197 


229 


70 


102 


198 


230 


71 


103 


199 


231 


72 


104 


200 


232 


73 


105 


201 


233 


74 


106 


202 


234 


75 


107 


203 


235 


76 


108 


204 


236 


77 


109 


205 


237 


78 


110 


206 


238 


79 


111 


207 


239 


80 


112 


208 


240 


81 


113 


209 


241 


82 


114 


210 


242 


83 


115 


211 


243 


84 


116 


212 


244 


85 


117 


213 


245 


86 


118 


214 


246 


87 


119 


215 


247 


88 


120 


216 


248 


89 


121 


217 


249 


90 


122 


218 


250 


91 


123 


219 


251 


92 


124 


220 


252 


93 


125 


221 


253 


94 


126 


222 


254 


95 


127 


223 


255 
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The following short program demonstrates and confirms Table 12-3. This program 
prints the ATASCII code for a character in the text window and the character itself in 

key, a new character appears. 



return 



the graphics window. Every time you press the 
The reason SETCOLOR 4,0,0 is the same as SETCOLOR 8,0,0 is to avoid a screen filled 
with hearts. Another way to accomplish this is to lower the character set into RAM (us- 
ing MOVE) and redefine the heart character as 8 by 8 zeros. See Appendix C, Alternate 
Character Sets, for an example of lowering and redefining the character set. The 
special character set is shown in the program as it is now written. To see the standard 
character set, just delete line 20. The GRAPHICS 2 instruction automatically pokes 
756,224. 



10 GRAPHICS 2 
20 POKE 756,226 
30 SETCOLOR 8,0,0 

40 SETCOLOR 4,0,0!AVOID SCREEN HEARTS 
50 SETCOLOR 5,4,6!PINK 
60 SETCOLOR 6,12,2!GREEN -h TEXT WINDOW 
70 SETCOLOR 7,9,6!LIGHT BLUE 
80 A$= INKEY$ 

90 IF A$ = "" THEN 80 
100 ON ERROR GOTO 150 
110 PRINT #6, AT(6,6);CHR$(X) 

120 PRINT X 
130 X = X-h1 
140 GOTO 80 

150 RUN IREPEATS WHEN 256 REACHED 



POINT- 

PLOTTING 

MODES 



GRAPHICS 3 through 8 plot individual points on your television screen. The number 
following GRAPHICS determines the size of the points you plot. GRAPHICS 3 has the 
largest plot points. The following program can be used in GRAPHICS 3 through 8 by 
changing line number 10 to the appropriate graphics number. Note that you must in- 
clude line 20 since it indicates that you are using COLOR 1 as a default (see Table 12-4 
for default colors). 



10 GRAPHICS 3 !CAN BE GRAPHICS 3 THROUGH 8 
20 COLOR 1 !YOU WANT DEFAULT COLOR - ORANGE 
30 PRINT "TYPE TWO NUMBERS - SEPARATE THE TWO" 
40 PRINT "NUMBERS WITH A COMMA" 

50 PRINT "PLOT X,Y" 

60 INPUT X,Y 
70 PLOT X,Y 
80 GOTO 30 



If you enter and run the above program you will see plot point 5,5 by typing 5,5 and 



pressing the 



RETURN 



key. The boundaries and middle of GRAPHICS 3 are as follows. 
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39, 0 



0 , 0 



0, 19 



19, 9 



four lines of text window. . . . 



39,19 



If you insert a new statement — statement 15 — 15 SETCOLOR 4,4,8 you will get 
large, pink dots instead of the default orange. This change to the original plotting pro- 
gram gives you pink plot points because SETCOLOR 4,x,x aligns with COLOR 1 in 
GRAPHICS 3. You can also make the text window at the bottom of the screen go away 
by changing statement 10 to 10 GRAPHICS 3 + 16. 

TABLE 12-4 

DEFAULT COLORS, MODE, SETCOLOR, AND COLOR 



Default 


Mode or 


Setcolor 


Color 


Description 


Colors 


Condition 


Register 


n 


and Comments 




GRAPHICS 0 


4 


Register 




Light blue 




5 


holds 


Character luminance 


Dark blue 




6 


character 


(same as background) 






7 




Character 


Black 


Text Mode 


8 


Border 




Orange 




4 




Character 


Light green 


GRAPHICS 1,2 


5 




Character 


Dark blue 




6 




Character 


Red 




7 




Character 


Black 


Text Modes 


8 




Character 

Background, border 


Orange 




4 


1 


Graphics point 


Light green 


GRAPHICS 3,5,7 


5 


2 


Graphics point 


Dark blue 




6 

7 


3 


Graphics point 


Black 


4- color modes 


/ 

8 


0 


Background, border 


Orange 


GRAPHICS 


4 


1 


Graphics point 




4 and 6 


5 

6 


- 





Black 


2- color modes 


7 

8 


0 


Background, border 




GRAPHICS 8 


4 


- 





Light blue 




5 


1 


— 


Dark blue 




6 

7 


2 


— — — 


Black 


1 color, 2 lums. 


/ 

8 


- 


Border 
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Note: Player-missile graphics color is SETCOLOR register, color, luminance, where 
register = 0,1 ,2,3 and determines color of player-missile 0,1 ,2,3, respectively. Player- 
missile graphics will work in all graphics modes. 



The following programs will work in GRAPHICS 1 or GRAPHICS 2. The programs show 
the alternate basic character set and special character set (POKE 756,226). To restart 
these two programs, press the 111111 key and type RUN followed by 

2 REM KEYBOARD TYPEWRITER 
10 GRAPHICS 2 

20 SETCOLOR 4,0,0!to avoid screen full of hearts in lowercase 
30 PRINT "TYPE Green/Blue/Red (C/B/R)" 

40 INPUT "AND PRESS RETURN? "; C$ 

50 IF C$ = "G" THEN K = 32 
60 IF C$ = "B" THEN K = 128 
70 IF C$ = "R" THEN K = 160 
80 PRINT "TYPE UPPER/LOWER (U/L )" 

90 INPUT "AND PRESS RETURN ? "; B$ 

100 IF BS = "U" THEN 120 
110 POKE 756,226 

120 PRINT "NOW TYPE - ALPHA + CTRL KEYS" 

130 A$= INKEYS 

140 IF AS = "" THEN 130 

150 A = ASC(A$)-T K!32 is green, 128 is blue, 160 is red 

160 PRINT A 

170 PRINT#6, CHRS(A); 

180 GOTO 130 



100 REM TWINKLE 
110 GRAPHICS 16 + 2 
120 X= RND(36) 

130 ON ERROR GOTO 150 
140 PRINT#6, TAB(X);"*" 
150 GRAPHICS 32 + 16 + 2 
160 RESUME 
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13 



PLAYERS AND 
MISSILES 



MAKING A 
PLAYER 

OUT OF PAPER 



PLAYER-MISSILE GRAPHICS 



The following BASIC commands are tools to help you construct and move players and 
missiles: 

MOVE instruction 
OPTION (PLM1 or PLM2) 

VARPTR (PLM1 or PLM2) 

SETCOLOR 0 or 1 or 2 or 3 



Cut a strip of paper about 2 inches wide from an 8 x 10 inch sheet of paper. Now draw 
an 8-bit-wide "byte" down the strip of paper. 



Hex &08 drawn on 8-bit strip. 
Hex &14 drawn on 8-bit strip. 
Hex &22 drawn on 8-bit strip. 
Hex &41 drawn on 8-bit strip. 



An upside down V is shown on the strip in binary and hex. This strip of paper is like a 
player. If you take the player strip and lay it vertically down the middle of the televi- 
sion screen, you have "positioned it with the horizontal position register." When you 
move the strip right and left, you are "poking new locations into the horizontal position 
register" to get that movement. 

The MOVE instruction is used to move the player-missile object up and down the 
player-missile strip. Your paper strip can serve to demonstrate how the MOVE instruc- 
tion works. Let's say that you have put the upside down V on your paper strip with a 
pencil that has an eraser. To move the object it is necessary for you to erase the whole 
object and rewrite it elsewhere on the strip. 

As you can imagine, vertical movement is slightly slower than horizontal movement. It 
is slower because it takes only a single poke to the horizontal position register for 
horizontal movement, but many erasures and redrawings are necessary to move an ob- 
ject vertically. 

In the actual MOVE instruction you state the lowest address of the object you want to 
move; then state the lowest address of the new area to which you want to move the 
object; and lastly, state how many bytes you want moved. Hence the format: MOVE 
from address, to address, no. of bytes. 
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HOW THE ATARI MICROSOFT BASIC INSTRUCTIONS ASSIST 
PLAYER-MISSILE GRAPHICS 



The OPTION (PLM1) zeros out and dedicates a single-line resolution player-missile 
area in RAM. OPTION (PLM2) is for double-line player-missile resolution. 

VARPTR(PLM1 or PLM2) points to the beginning memory location of the player-missile 
area in RAM. This is the point from which you must figure your offset or displacement 
to poke your image into the correct area. For example, the starting address (top of 
television screen) for player 0 in double-line resolution is VARPTR(PLM2) + 128. In 
double-line resolution each player is 128 bytes long. So if you wanted to poke a straight 
line in the middle of player 0, the poke would be POKE VARPTR(PLM2) + 192,&FF. 

The SETCOLOR instruction gives the register, color, and luminance assignments. In 
ATARI Microsoft BASIC the registers 0, 1, 2, and 3 are used for player-missiles 0, 1, 2, 
and 3. It is only necessary to specify SETCOLOR 0,5,10 to set player-missile 0; the CO- 
LOR instruction is not used. 

Remember that you must poke decimal location 559 with decimal 62 for single-line 
resolution or with decimal 46 for double-line resolution. You must also poke decimal 
location 53277 with decimal 3 to enable player-missile display. 

You can use player-missile graphics in all modes. Missiles consist of 2-bit-wide "strips." 
Missiles 0, 1, 2, 3 are assigned the same colors as their associated player. Thus, when 
SETCOLOR sets the color of player 1 to red, it also sets missile 1 to red. 



The terms player and missile are derived from the animated graphics used in ATARI 
video games. Player-missile binary tables reside in player-missile graphics RAM. This 
RAM accommodates four 8-bit players and four 2-bit missiles (see Figure 13-1). Each 
missile is associated with a player, unless you elect to combine all missiles to form a 
fifth, independent player (see "Priority Control"). 

A player, like the spaceship shown in Figure 13-2, is displayed by mapping its binary 
table directly onto the television screen, on top of the playfield. The first byte in the 
table is mapped onto the top line of the screen, the second byte onto the second line, 
and so forth. Wherever 1 r s appear in the table, the screen pixels turn on; wherever 0's 
appear, the pixels remain off. The pattern of light and dark pixels creates the image. 

You can display player-missile graphics with single-line resolution (use OPTION(PLMI)) 
or double-line resolution (OPTION(PLM2)). If you select single-line resolution, each 
byte of the player will be displayed on a single scan line. If you choose double-line 
resolution, each byte will occupy two scan lines and the player will appear larger than 
in single-line resolution. Each player is 256 bytes long with single-line resolution, or 128 
bytes long with double-line resolution. Line resolution only needs to be programmed 
once. The resolution you choose will apply to all player-missile graphics in your pro- 
gram. The Player-Missile Graphics Demonstration Program included in this section is 
an example of double-line resolution programming. 

Player-missile graphics give you considerable flexibility in programming animated 
video graphics. Registers are provided for player-missile color, size, horizontal position- 
ing, player-playfield priority, and collision control. 



PMBASE 

Register 



VARPTR (PLM2) 

Missiles 
+ 128 



+ 256 
+ 384 
+ 512 
+ 640 



Double-Line 

Resolution 



Single-Line 

Resolution 



Unavailable 



M3 



M2 



Ml 



MO 



Player 0 



Player 1 



Player 2 



Player 3 



Unavailable 



M3 



M2 



Ml 



Player 0 



Player 1 



Player 2 



Player 3 



MO 



PMBASE 



VARPTR (PLM1) 

Missiles 
+ 256 



+ 512 



+ 768 



+ 1024 



+ 1280 



Figure 13-1 Player-Missile Graphics RAM Configuration 



GRAPHIC BINARY HEXADECIMAL DECIMAL 

REPRESENTATION REPRESENTATION REPRESENTATION REPRESENTATION 




00000000 


0 


0 


1 0000001 


81 


129 


10011001 


99 


153 


10111101 


BD 


189 


11111111 


FF 


255 


10111101 


BD 


189 


10011001 


99 


153 


00000000 


0 


0 



Figure 13-2 Mapping the Player 
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COLOR 

CONTROL 



SIZE CONTROL 



The ATARI 400 and ATARI 800 Computers have nine registers for user control of 
player-missile, playfield, and background color: 

TABLE 13-1 

SETCOLOR REGISTER ASSIGNMENTS 



SETCOLOR Register, Color, Luminance Function 



SETCOLOR 0, color, luminance 
SETCOLOR 1, color, luminance 
SETCOLOR 2, color, luminance 
SETCOLOR 3, color, luminance 
SETCOLOR 4, color, luminance 
SETCOLOR 5, color, luminance 
SETCOLOR 6, color, luminance 
SETCOLOR 7, color, luminance 
SETCOLOR 8, color, luminance 



Color-luminance of Player-Missile 0 
Color-luminance of Player-Missile 1 
Color-luminance of Player-Missile 2 
Color-luminance of Player-Missile 3 
Color-luminance of Playfield 0 
Color-luminance of Playfield 1 
Color-luminance of Playfield 2 
Color-luminance of Playfield 3 
Color-luminance of background 



Players are completely independent of the playfield and of each other. Missiles share 
color registers with their players and hence are the same color as their players. If you 
combine missiles to form a fifth player, they assume the color of playfield color- 
luminance register 3 (COLPF3). 

To program color, specify the register, the hue, and the luminance. Use the SETCOLOR 
command. See lines 20 and 100 of the Player-Missile Graphics Demonstration Program 
for examples. See also "Graphics," Section 12. 

Each color-luminance register is independent. Therefore, you could use as many as 
nine different colors in a program, depending upon the graphics mode selected. All 
registers cannot be used in all graphics modes (see "Graphics," Section 12). 



Five size-control registers are provided — four for the players and one for all four 
missiles: 



TABLE 13-2 

REGISTERS CONTROLLING WIDTH OF PLAYER-MISSILES 



Size 

Register 


Address 

Hex 


Dec 


Function 


SIZEP0 


D008 


53256 


Controls size of Player 0 


SIZEP1 


D009 


53257 


Controls size of Player 1 


SIZEP2 


D00A 


53258 


Controls size of Player 2 


SIZEP3 


D00B 


53259 


Controls size of Player 3 


SIZEM 


D00C 


53260 


Controls size of missiles 



Size-control registers allow you to double or quadruple the width of a player or missile 
without altering its bit resolution. To double the width, poke a 1 into the size register; 
to quadruple the width, poke a 3; and to return a player or missile to normal size, poke 
a 0 or 2. An example is given in line 80 of the Player-Missile Graphics Demonstration 
Program. 
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• 

POSITION AND 
MOVEMENT 



VERTICAL 

Vertical position is set when you specify the location of the player-missile in player- 
missile graphics RAM. The lower you place the player-missile in RAM, the higher the 
image will be on the television screen. A positioning technique is illustrated by lines 
120 and 200 of the Player-Missile Graphics Demonstration Program at the end of this 
section. 



To program vertical motion, use the MOVE command (see lines 350 and 390 of the 
Player-Missile Graphics Demonstration Program). Since the MOVE command does not 
zero the old location after the move, an extra zero at each end of the player is used to 
"cleanup" as the player is being moved. Give the current position of the player in 
RAM, the direction of the move through RAM (forward = +, backward = - ), and the 
number of player bytes to be moved. Each byte of the player must be moved. Follow- 
ing the MOVE command, increment or decrement the vertical position counter (see 
lines 360 and 400 of the Player-Missile Graphics Demonstration Program). 



HORIZONTAL 

Each player and missile has its own horizontal position register, so players can move in- 
dependently of each other, and missiles can move independently of their players. 



TABLE 13-3 

PLAYER-MISSILE HORIZONTAL POSITION REGISTERS 



Position 

Register 


Address 

Hex 


Dec 


Function 


HPOSPO 


D000 


53248 


Horizontal position of Player 0 


HPOSP1 


D001 


53249 


Horizontal position of Player 1 


HPOSP2 


D002 


53250 


Horizontal position of Player 2 


HPOSP3 


D003 


53251 


Horizontal position of Player 3 


HPOSMO 


D004 


53252 


Horizontal position of Missile 0 


HPOSM1 


D005 


53253 


Horizontal position of Missile 1 


HPOSM2 


D006 


53254 


Horizontal position of Missile 2 


HPOSM3 


D007 


53255 


Horizontal position of Missile 3 




To set the position of a player or missile, poke its horizontal position register with the 
number of the position. To program horizontal movement, simply change the number 
stored in the register. See lines 100 and 180 of the Player-Missile Graphics Demonstra- 
tion Program for examples. 

A horizontal position register can hold 256 positions, but some of these are off the left 
or right margin of the television screen. A conservative estimate of the range of player 
visibility is horizontal positions 60 through 200. The actual range will depend upon the 
television set. 



DIAGONAL 




Horizontal and vertical moves can be combined to move the player diagonally. Set the 
horizontal position first, then the vertical position. See lines 270 through 390 of the 
Player-Missile Graphics Demonstration Program. 
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PRIORITY 

CONTROL 



COLLISION 

CONTROL 



The Priority Control Register (PRIOR, &D01 B; OS shadow GPRIOR,&26F) enables you 
to select player or playfield color register priority and to combine missiles to form a 
fifth player. 



PRIORITY SELECT 

You have the option to specify which image will have priority in the event player and 
playfield images overlap. This feature enables you to make players disappear behind 
the playfield and vice versa. To set the priority, poke one of the following numbers into 
the Priority Control Register: 

1 = All players have priority over all playfields. 

2 = Players 0 and 1 have priority over all playfields, and all playfields have 

priority over players 2 and 3. 

4 = All playfields have priority over all players. 

8 = Playfields 0 and 1 have priority over all players, and all players have priority 
over playfields 2 and 3. 



ENABLE FIFTH PLAYER 



Setting bit D4 of the Priority Control Register causes all missiles to assume the color of 
Playfield Register 3 (&2C7, dec. 711). You can then combine the missiles to form a fifth 
player. If enabled, the fifth player must still be moved horizontally by changing all 
missile registers (&D004 through &D007) together. 



Collision control enables you to tell when a player or missile has collided with another 
graphics object. There are 16 collision control registers. 



TABLE 13-4 

COLLISION CONTROL REGISTERS FOR PLAYER-MISSILES 



Collision 

Register 


Address 

Hex 


Dec 


Function 


MOPF 


D000 


53248 


Missile 0 to playfield 


Ml PF 


D001 


53249 


Missile 1 to playfield 


M2PF 


D002 


53250 


Missile 2 to playfield 


M3PF 


D003 


53251 


Missile 3 to playfield 


POPF 


D004 


53252 


Player 0 to playfield 


PI PF 


D005 


53253 


Player 1 to playfield 


P2PF 


D006 


53254 


Player 2 to playfield 


P3PF 


D007 


53255 


Player 3 to playfield 


MOPL 


D008 


53256 


Missile 0 to player 


Ml PL 


D009 


53257 


Missile 1 to player 


M2 PL 


DOOA 


53258 


Missile 2 to player 


M3PL 


DOOB 


53259 


Missile 3 to player 


POPL 


DOOC 


53260 


Player 0 to player 


PI PL 


DOOD 


53261 


Player 1 to player 


P2PL 


DOOE 


53262 


Player 2 to player 


P3PL 


DOOF 


53263 


Player 3 to player 
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In each case, only the rightmost 4 bits of each register are used. They are numbered 0, 
1, 2, and 3 from the right and designate, by position, which playfield or player the rele- 
vant player or missile has collided with. A one in any bit position indicates collision 
since the last HITCLR. 



CLEARING COLLISION REGISTERS 

All collision registers are cleared at once by writing a zero to the HITCLR register 
(&D01E, dec. 53278). 



PLAYER-MISSILE 
GRAPHICS 
DEMONSTRA- 
TION PROGRAM 



The following ATARI Microsoft BASIC program creates a player (spaceship) that 
shoots missiles and can be moved in all directions with the joystick. Connect a joystick 
controller to CONNECTOR JACK 1 on the front of your ATARI Home Computer. 

05 ! DOUBLE-LINE RESOLUTION PLAYER AND MISSILE 

10 GRAPHICS 8 

20 SETCOLOR 6,0,0 

30 X = 130 

40 Y = 70 

50 STICK0 = &278 

60 OPTION PLM2 

70 POKE 559,46 

80 POKE &D00C,1 

90 POKE &D01 D,3 

100 POKE &D000,X 

110 SETCOLOR 0,3,10 

120 FOR J = VARPTR(PLM2) + 128 + Y TO VARPTR(PLM2) + 135 + Y:READ A:POKE 
J,A 

125 NEXT J 

130 DATA 0,129,153,189,255,189,153,0 
140 IF PEEK(&D01 0) = 1 THEN 220 
150 SOUND 0,220,1 2,1 5, 1 NT(X/30) 

160 ZAP = X 

170 POKE VARPTR(PLM2) + 4 + Y,3 
180 POKE &D004,ZAP 
190 ZAP = ZAP-12 

200 IF ZAP <12 THEN POKE VARPTR(PLM2) + 4 + Y,0:GOTO 220 ELSE 180 
210 ! JOYSTICK MOVES 

220 A = PEEK(STICKO): IF A = 15 THEN GOTO 140 
230 IF A = 11 THEN X = X-1 
240 IF A = 7 THEN X = X + 1 
250 POKE &D000,X 

260 IF A = 14 THEN GOTO 350 IMOVE UP 
270 IF A = 13 THEN GOTO 390 IMOVE DOWN 
280 IMOVE DIAGONALLY 

290 IF A =10 THEN X = X-1. POKE &DOOO,X:GOTO 350 

300 IF A = 6 THEN X = X + 1:POKE &DOOO,X:GOTO 350 

310 IF A = 9 THEN X = X-1:POKE &DOOO,X:GOTO 390 

320 IF A = 5 THEN X = X + 1:POKE &DOOO,X:GOTO 390 

330 GOTO 140 
340 IMOVE UP 

350 MOVE VARPTR(PLM2) + 128 + Y,VARPTR(PLM2) + 128 + (Y-1),8 



Player-Missile Graphics 81 



ANNOTATION 



360 Y = Y-1 
370 GOTO 140 
380 !MOVE DOWN 

390 MOVE VARPTR(PLM2) + 128 + (Y-1 ),VARPTR(PLM2) + 1 28 -E Y,8 

400 Y = Y + 1 

410 GOTO 140 

420 STOP 

430 END 



Line 

10 



20 



30,40 

50 

60 

70 



80 



90 

100 

110 



Sets a high-resolution graphics mode with no text window. You can pro- 
gram player-missile graphics in any graphics mode. See Section 12, 
"Graphics" and Table 12-4. 

Sets the background color to black, as follows: 

6 = Background Color-Luminance Register (COLBK, &D01A); 

0 = Black (see Color Table 12-1); 

0 = Zero luminance. The luminance value is an even number be 
tween 0 and 14. The higher the number, the greater the 
luminance and the brighter the color. 

Initializes player position variables X (horizontal) and Y (vertical). 

Assigns the label STICK0 to joystick register 278. 

Specifies doubleline resolution RAM for the player-missile graphics (see 
Figure 13-1). PLM1 would specify singleline resolution. 

Sets the Direct Memory Access Control Register (DMACTL, 559) for 
doubleline resolution (46). A 62 would specify singleline resolution. 

Note When DMACTL is enabled, the player-missile graphics registers 
(GRAFP0-GRAFP3 and GRAFM) are automatically loaded with data 
from the player-missile RAM. 

Doubles the width of the missile by poking the Size Control Register 
(SIZEM, &D00C) with 1 . Poking the register with a 3 would quadruple 
the width. 

Enables the Graphics Control Register (GRACTL, &D01D) to display 
player-missile graphics (3 enables, 0 disables). 

Pokes the horizontal position of the player (X = 130 from line 30) into 
the player 0 Elorizontal Position Register (HPOSPO, &D000). 

Colors the player and missile bright red-orange as follows: 

0 = Player-missile 0 Color-Luminance Register (COLPMO, 
&D012); 

3 = Red-orange (see Color Table 12-1); 

10 = Luminance or brightness (see annotation of line 20). 
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120125 

140 

150 



160 

170 

180 

190 

200 

220 

230/250 



Sets variable pointer VARPTR(PLM2) to the player-missile starting ad- 
dress in player-missile graphics RAM (see Figure 13-1). Pokes data 
from line 130 into the player area, VARPTR(PLM2) + 128 + Y to 
VARPTR(PLM2) + 135 + Y. The computer uses the data in line 130 to 
map the spaceship onto the screen (see Figure 13-2). 

Tells the computer to read the joystick 0 trigger register (TRIC0, 
&D010). If the trigger button is not activated (&D010 = 1), the com- 
puter will go to line 220 and read the joystick position; if the button is 
activated (&D010 = 0), the computer will execute lines 150 through 
200. 

Generates sound each time the joystick button is pressed. Sound is 
programmed as follows: 

(1) Select voice. As many as four voices (0 to 3) can be used, but 
each voice requires a separate SOUND statement. 

(2) Choose pitch from Table 14-1 . The larger the number, the lower 
the pitch. 

(3) Set distortion or noise level, using an even number between 0 
and 14. A 10 gives a pure tone; 12 gives a buzzer effect. 

(4) Set volume, an odd number between 1 and 15. The larger the 
number, the louder the sound. 

(5) Set duration of sound per second (20 = 20/60 or Vs second). 

Sets the horizontal position of the missile (ZAP) equal to the horizon- 
tal position of the player (X). 

Turns on the screen pixels corresponding to the missile 0 RAM area 
[VARPTR(PLM2)-F4 + Y] to display the missile (3 = ON; 0 = OFF). 

Pokes the horizontal position of the missile (ZAP = X from line 160) 
into the missile 0 horizontal position register (HPOSMO, &D004). 

Decrements the missile 0 horizontal position counter by 12 to create 
a horizontal 'line of fire" from the player. 

If the missile's horizontal position is less than 12 (off the left side of 
the screen), the computer pokes 0's into the missile RAM area to clear 
it and goes to line 220. If the missile's horizontal position is 12 or 
greater, the computer pokes the new hrizontal position into FiPOSMO 
(register &D004 in line 180) and decrements the horizontal position 
counter by 12 (line 190). 

Tells the computer to read the STICK0 register and find the position 
of the joystick (see Figure 1 3-3). If the position is 1 5 (neutral), the com- 
puter goes to line 140 and reads the joystick trigger register (&D010). 

If the joystick is moved left (11), the computer decrements the 
horizontal position counter and pokes the spaceship's new horizontal 
position into the HPOSPO register (&D000). 
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240/250 



If the joystick is moved right (7), the computer increments the 
horizontal position counter and pokes the spaceship's new horizontal 
position into HPOSPO. 



260 If the joystick is moved up (14), the computer moves the spaceship 

back one byte in player-missile RAM (line 350). Each of the 8 bytes 
that comprise the spaceship must be moved back. When the move is 
completed, the computer decrements the vertical position counter 
(line 360). 

270 If the joystick is moved down (13), the computer advances the 

spaceship one byte in player-missile RAM (line 390) and increments 
the vertical position counter (line 400). 

290 - 320 If the joystick is moved diagonally (10, 6, 9, or 5), the computer ex- 

ecutes a horizontal move (after resetting the horizontal position 
register), makes a vertical move (line 350 or 390), and resets the ver- 
tical position counter (line 360 or 400). 



14 




13 



Figure 13-3 Joystick Controller Positions 
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14 



SOUND 



SOUND 



Format: SOUND voice, frequency, distortion, volume, duration 
Examples: 120 SOUND 2,204,10,12,244 
100 SOUND 0,122,8,10 

Voice. There can be up to four voices specified by the numbers 0 through 3. 
Frequency. From 0-255 (see Frequency Chart, Table 14-1). 

Distortion. The default is a pure tone. Even numbers between 0 and 14 define the 
distortion. A 10 is used to create a "pure" tone. A 12 gives a buzzer sound. 



Volume. A number between 0 and 15. Use a 1 to create a sound that is barely audible. 
Use a 15 to make a loud sound. A value of 8 is considered normal. If more than one 
sound statement is being used, the total volume should not exceed 32. This will create 
an unpleasant "clipped" tone. 



Duration. Duration is given in 1/60 of a second. The duration indicates how long a tone 
or noise will last. If you do not specify a number for the duration parameter, the tone 
will continue until the program reaches an END statement, another RUN statement, or 

the same voice number followed by 

Example: SOUND 2,204,10,12 
SOUND 2, 0,0,0 



until you type a second SOUND statement using 
0,0,0. You can also stop the tone by pressing the 
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TABLE 14-1 

FREQUENCY CHART OF PITCH VALUES 



HIGH NOTES 



MIDDLE C 



Notes 


Hex 


Decimal 


C 


ID 


29 


B 


IF 


31 


A# or Bt 


21 


33 


A 


23 


35 


G# or A^ 


25 


37 


G 


28 


40 


F# or Gt 


2A 


42 


F 


2D 


45 


E 


2F 


47 


D# or E 


32 


50 


D 


35 


53 


C# or D t 


39 


57 


C 


3C 


60 


B 


40 


64 


A# or B 


44 


68 


A 


4B 


72 


G# or At 


4C 


76 


G 


51 


81 


F# or G t 


55 


85 


F 


5B 


91 


E 


60 


96 


D# or E t 


66 


102 


D 


6C 


108 


C# or Dt 


72 


114 


C 


79 


121 


B 


80 


128 


A# or Bt 


88 


136 


A 


90 


144 


G# or At 


99 


153 


G 


A2 


162 


F# or Gt 


AD 


173 


F 


B6 


182 


E 


Cl 


193 


D# or Et 


CC 


204 


D 


D9 


.217 


C# or Dt 


E6 


230 


C 


F3 


243 



LOW NOTES 



Example Program: 

NIGHT LAUNCH 



10 GRAPHICS 2 + 16 
20 SETCOLOR 4,8,4 

30 PRINT#6, AT(3 # 3);"NIGHT LAUNCH" 

40 FOR DELAY = 1 TO 1000:NEXT 

50 GRAPHICS 2 + 16 

60 PRINT#6, AT(3,3);"AT THE CAPE" 

70 FOR DELAY = 1 TO 1000: NEXT 

80 GRAPHICS 0 

90 POKE 752,1 

100 SETCOLOR 6,0,0 

110 FOR T = 1 TO 24:PRINT "":NEXT 

120 PRINT T A B(1 1 ); C H R$(8); C H R$(1 0) 

130 PRINT TA B(1 1 );C H R$(22);CH R$(2) 

140 PRINT TAB(1 1 );CH R$(22);CH R$(2) 

150 PRINT TA B(1 1 );C H R$(1 3);C H R$(1 3) 

160 PRINT T A B(1 1 ); C H R$(6); C H R$(7) 

170 FOR VOL = 15 TO 0 STEP -1 

180 SOUND 2, 77, 8, VOL 

190 PRINT CHR$(1 55)!MOVES ROCKET UP 

200 FOR R = 1 TO 200:NEXT R 

210 NEXT VOL 

220 END 

The above program is a demonstration of the SOUND statement. It decreases (by a 
loop) the volume of a distorted sound. The sound effect resembles a rocket taking off 
into outer space. 
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15 



PADDLE 

CONTROLLERS 



GAME CONTROLLERS 



In ATARI Microsoft BASIC, the game controllers are sensed with the PEEK instruction. 
The controllers are attached directly to the four controller jacks in the front of the 
ATARI Home Computer. The PEEK locations can be given the same names listed 
below or you can give them short variable names. A complete list of PEEK locations is 
given in Appendix E. 




PADDLE CONTROLLERS 

Figure 15-1 Came Controllers 



The following example program senses and prints the status of paddle controller 0 (first 
paddle in leftmost port). This PEEK can be used with other functions or commands to 
"cause" further actions like sound, graphics controls, etc. An example is the statement 
IF PADDLE(0)>14 THEN GOTO 440. Peeking the paddle address returns a number be- 
tween 1 and 228, with the number increasing in size as the knob on the controller is 
rotated counterclockwise (turned to the left). 

Example of initializing and using PEEK for PADDLE(O): 

10 PADDLE(O) = 624 
20 PRINT PEEK(PADDLE(0)) 

30 GOTO 20 

PADDLE number and PEEK locations (decimal addresses): 

PADDLE(O) = 624 
PADDLE(1) = 625 
PADDLE(2) = 626 
PADDLE(3) = 627 
PADDLE(4) = 628 
PADDLE(5) = 629 
PADDLE(6) = 630 
PADDLE(7)=631 
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KEYBOARD 

CONTROLLERS 



JOYSTICK 

CONTROLLERS 



Peeking the following addresses returns a status of 0 if you press the trigger button of 
the designated controller. Otherwise, it returns a value of 1. 

Example of using paddle trigger (0): 

10 PTRIG(0) = &27C 
20 PRINT PEEK(PTRIG(0)) 

30 GOTO 20 

PTRIG (paddle trigger) number and PEEK locations (decimal): 



PTRIG(0) = 636 
PTRIG(1) = 637 
PTRIG(2) = 638 
PTRIG(3) = 649 
PTRIG(4) = 640 
PTRIG(5) = 641 
PTRIG(6) = 642 
PTRIG(7) = 643 



Peeking the joystick locations (addresses) works in the same way as for the paddle con- 
trollers, but can be used with the joystick controller. The joystick controllers are 
numbered 0-3 from left to right. 

Example of using joystick (0): 

10 STICK(0) = 632 
20 PRINT PEEK(STICK(0)) 

30 GOTO 20 



STICK (joystick) number and PEEK (decimal) locations: 

STICK(0)= 632 
STICK(1) = 633 
STICK(2)= 634 
STICK(3) = 635 



Figure 15-2 shows the PEEK number that will be returned for the various joystick posi- 
tions: 



14 




Figure 15-2 joystick Triggers 
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Sensing the joystick triggers works the same way as for the paddle trigger buttons. It 
can be used with both the joystick and keyboard controllers. 

Using joystick trigger (0): 

10 STRIG(0) = 644 
20 PRINT PEEK(STRIG(0)) 

30 GOTO 20 



STRIG (joystick) number and PEEK (decimal) locations: 

STRIC(0) = 644 
STRIG(1) = 645 
STRIG(2) = 646 
STRIG(3) = 647 



5 REM THIS PROGRAM WILL SAY "BANG!" WHEN JOYSTICK RED BUTTON IS 

6 REM PRESSED 

10 IF PEEK(644) = 0 THEN ? "Bang!" 

20 IF PEEK(644) = 1 THEN CLS 
30 GOTO 10 



CONSOLE KEYS The following program reads the console keys on the right-hand side of the ATARI 

Computer: 

10 POKE 53279,0 
20 PRINT PEEK(53279) 

30 GOTO 20 



Peeking location 53279 (decimal) will return a number that indicates which key was 
pressed. 

7 = No key pressed 
6 = fljppfl key pressed 

3 = key pressed 
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APPENDIX A 



SAMPLE PROGRAMS 



DISK DIRECTORY PROGRAM 



Features used: 

• User-callable CIO routines (CIOUSR) (See Appendix N.) 

• Integers 

• VARPTR function 

• ON ERROR 

• On-line comments 



10 ! 

20 ! 

30 ! 

40 ON ERROR 350 
50 OPTION RESERVE(200) 

60 OPEN#1/ , D:CIOUSR // INPUT 
80 ADDR = VARPTR(RE SERVE) 

90 FOR 1=0 TO 159 

100 GET#1,D:POKE ADDR+I,D 

110 NEXT I 

120 CLOSE #1 

130 PUTIOCB = ADDR 

140 CALLCIO = ADDR + 61 

150 GETIOCB = ADDR + 81 

160 DIM IOCB%(1 0) 

170 IOCB%(0) = 1 
180 IOCB%(1)=3 
190 IOCB%(2) = 6 
200 FSPEC$ = "D:*.*" 

210 ! 

220 Z = VARPTR(FSPEC$) 

230 Y = VARPTR(IOCB%(3)) 

240 POKE Y,PEEK(Z + 2) 

250 POKE Y + 1,PEEK(Z + 1) 

260 ! 

270 Z= USR(PUTIOCB / VARPTR(IOCB%(0))) 
280 ! 

290 Z= USR(CALLCIO,VARPTR(IOCB%(0))) 
300 ! 

310 ! 

320 INPUT #1,S$ 

330 PRINT S$ 

340 GOTO 320 
350 CLOSE #1 
360 END 



ROUTINE TO READ 
DISK DIRECTORY 



!GET SPACE FOR CIOUSR ROUTINES 
IOPEN FILE 

!GET STARTING ADDRESS OF RESERVED AREA 
IPOKE IN CIOUSR ROUTINES 



ITHESE ARE THE PROPER STARTING POINTS 

IFOR EACH OF THE 

IROUTINES 

IDATA FOR ROUTINES TAKES 10 BYTES 

IUSE IOCB #1 

IDO A CIO "OPEN" CALL 

IFOR DIRECTORY INPUT 

IDIR FILE SPEC 

IPUT ADDRESS OF FSPEC INTO BUFFER 
IADDRESS OF THE STRING FILESPEC 
IADDRESS OF THE PROPER ARRAY POSITION 
IHIGH ADDRESS BYTE 
I LOW ADDRESS BYTE 
PUTDATA INTO IOCB 

THEN CALL CIO 

IOCB IS SETUP AND DISK 
IS OPEN... READ DIRECTORY 
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EXPLOSION SUBROUTINE 



Feature used: Sound 

10 ! TWO-LINE MAIN PROGRAM 
20 !AND SUBROUTINE TO PRODUCE 
30 !AN EXPLOSION 
40 ! 

50 GOSUB 8000 
60 STOP 
8000 ! 

8010 ! EXPLOSION SUBROUTINE 
8020 ! 

8030 SOUND 2,75,8,14 
8040 ICR = 0.79 
8050 VI = 1 5: V2 = 1 5: V3 = 1 5 
8060 SOUND 0,NTE,8,V1 
8070 SOUND 1,NTE + 20,8,V2 
8080 SOUND 2,NTE + 50,8,V3 
8090 VI = VI * ICR 
8100 V2 = V2 * (ICR + .05) 

8110 V3 = V3 * (ICR+.08) 

8120 IF V3 > 1 THEN 8060 
8130 SOUND 0,0, 0,0,0 
8140 SOUND 1,0, 0,0,0 
8150 SOUND 2, 0,0, 0,0 
8160 RETURN 



FANFARE MUSIC EXAMPLE 



Feature used: Sound with duration 



10 'ROUTINE TO GENERATE FANFARE MUSIC 
20 ! TWO-LINE MAIN PROGRAM 
30 ! 

40 GOSUB 8000 
50 STOP 
8000 ! 

8010 IFANFARE MUSIC 
8020 ! 

8030 DUR = 20:V0 = 181:V1 =144:V2 = 121:GOSUB 8200 
8040 DUR= 7:COSUB 8200 
8050 GOSUB 8200 

8060 DUR = 9.V0 = 162:V1 =128:V2 = 108:GOSUB 8200 

8070 DUR = 1 5: V0 = 1 81 : VI = 1 44: V2 = 1 21 :GOSU B 8200 

8080 V0 = 162: VI =128:V2 = 108:GOSUB 8200 

8090 V0 = 153: VI =128:V2 = 96:V3 = 193 

8100 For 1 = 2 TO 14 

8110 SOUND 3, V0, 10, 1 
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8120 SOUND 1, VI, 10, 1 
8130 SOUND 2,V2,10,I 
8140 SOUND 0,V3,10,I 
8150 FOR J =1 TO 100: NEXT J 
8160 NEXT I 

8170 FOR J=1 TO 200: NEXT J 
8180 SOUND 0,0, 0,0,0 
8185 SOUND 1,0, 0,0,0 
8190 SOUND 2, 0,0, 0,0 
8195 SOUND 3, 0,0, 0,0 
8197 RETURN 

8200 1SOUND GENERATOR 
8210 SOUND 0,V0,10,8,DUR 
8220 SOUND 1 ,V1 ,10,8,DUR 
8230 SOUND 2,V2,10,8,DUR 
8240 ! 

8250 !NOW STOP THE SOUND 
8260 ! 

8270 SOUND 0,0, 0,0,0 
8280 SOUND 1,0, 0,0,0 
8290 SOUND 2, 0,0, 0,0 
8295 FOR J=1 TO 250:NEXT J 
8300 RETURN 



EXAMPLE OF ATARI PIANO 

Features used: 

• OPEN statement 

• String array 

• INKEY$ 

• SOUND 

• On-line comments 
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170 NEXT I 
180 CLOSE #1 

190 PRINT "PLAY, BURT, PLAY!" 

200 ! 

210 ! BEGIN TESTING FOR KEYS 
220 ! BEING PRESSED 
230 ! 

240 N$ = INKEYS 

250 IF N$ = "" THEN GOTO 240 ELSE GOTO 320 
260 ! 

270 ! WHEN A KEY IS PRESSED, 

280 ! SEE IF ITS ONE ON OUR 
290 ! PIANO KEYBOARD! 

300 ! 

310 ! 

320 FOR I = 1 TO 15 

330 IF N$ = SCALE$(I) GOTO 380 

340 NEXT I 

350 GOTO 240 !NOT A GOOD KEY, TRY AGAIN 
360 ! FOUND A GOOD KEY, PROCESS IT 
370 ! 

380 VOLUME = 8 

390 SOUND 1,PITCH(I), 10, VOLUME, 15 
400 GOTO 240 
410 END 



Sample NOTES.DAT FILE 

First item is the key to be pressed. 

Second item is the frequency to play. 



NOTE.DAT CREATION PROGRAM 

10 ! PROGRAM TO CREATE NOTES.DAT FILE 
20 ! 

30 DIM N OT E S$(1 5), P I TC H(1 5) 

40 FOR 1=1 TO 15 

50 INPUT "ENTER KEY, FREQ. FOR KEY :";NOTES$(l),PITCH(l) 
60 NEXT I 

70 OPEN $1,"D:T" OUTPUT 

80 FOR 1=1, TO 15 

90 PRINT $1,NOTES$(l);",";PITCH(l) 

100 NEXT I 
110 CLOSE $1 
120 END 



Enter the following values to get a 2-octave scale. 

Z, 243 
X, 217 
C, 193 
V, 182 
B, 162 
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N, 144 
M, 128 
A, 121 
S, 108 
D, 96 

F, 91 

G, 81 

H, 72 

J, 64 

K, 60 



DECIMAL-TO-HEX CONVERSION ROUTINE 



Features used: 

• String array 

• Integers 

• On-line comments 



20 ! 

30 ! D E C H E X 
40 ! 

50 ! 

60 ! 

70 ! PROGRAM TO CONVERT AN INPUT 
80 !DECIMAL NUMBER TO ITS 
90 [HEXADECIMAL EQUIVALENT 
100 ! 

110 ! 

130 DIM HEX$(1 5):DIM HEXBASE(4) 

140 FOR 1 = 0 TO 15 
150 READ HEX$(I) 

160 NEXT I 

170 FOR 1 = 0 TO 4 

180 READ HEXBASE(I) 

190 NEXT I 

200 DATA 0,1 ,2,3,4,5,6,7,8,9,A,B,C,D,E,F 
210 DATA 0,4096,256,16,1 
220 ! 

230 !GET THE DECIMAL NO. 

240 ! 

250 INPUT "ENTER THE DECIMAL NO. :";DEC 
260 IF DEC = 0 THEN 500 [STOP 
270 ! 

280 [PROCESS EACH HEX DIGIT 
290 ! 

300 FOR J = 1 TO 4 

305 IF J = 4 THEN ANS% = DEC: GOTO 350 
310 ANS% = (DEC/HEXBASE(J))- .5 
320 IF ANS% < 1 THEN ANS% = 0 
330 DEC = DEC - (ANS% * HEXBASE(J)) 

340 ! 

350 ! FIND THE HEX DIGIT FOR FIRST POSITION 



360 FOR 1% = 0 TO 15 

370 IF ANS% = 1% THEN GOTO 420 

380 NEXT 1% 

390 ! IF WE GOT HERE ITS AN ERROR! 

400 PRINT " DECIMAL INPUT CAN'T BE COMPUTED" 
410 PRINT "PLEASE TRY AGAIN": GOTO 250 
420 HEXNOS = HEXNO$ + HEX$(I%) 

430 NEXT J 
440 ! 

450 !PRINT THE HEX NO. AND GO FOR ANOTHER 
460 ! 

470 PRINT "HEX NO. = ";HEXNO$ 

480 HEXNO$ = "" 

490 GOTO 250 
500 END 



VERTICAL FINE SCROLLING 



Features used: 

• Fine scrolling 

• VARPTR 

• OPTION RESERVE and CHR 

• User-defined display list 



10 DEFINT A-Z 

20 OPTION RESERVE(3000) !AREA FOR SCREEN RAM 
30 OPTION CHR1 !AREA FOR DISPLAY LIST 
40 ADDR = VARPTR(CHRI) 

50 CADDR = VARPTR(RESERVE) 

60 VSCROL = &D405 !VERTICAL SCROLL REGISTER 
70 LCADDR = 0 

80 HCADDR = ((CADDR AND &FF00)/256) AND &FF 

90 FOR 1=0 TO 99 !ZERO THE DISPLAY LIST AREA (1ST 100 BYTES) 

100 POKE ADDR+ l,0:NEXT I 

110 LADDR = ADDR AND &FF 

120 HADDR = ((ADDR AND &FF00)/256) AND &FF 

130 LMSLO = ADDR+4 IADDRESS OF LOAD 

140 LMSHI = ADDR+5 1MEMORY SCAN BYTES (LMS) 

150 FOR 1=0 TO 18 !POKE IN NEW DISPLAY LIST 
160 READ D !FROM DATA STMTS. 190-210 
170 POKE ADDR+I,D 
180 NEXT I 

190 DATA &70,&70,&70,&67,&00,&00,&27,&27 
200 DATA &27,&27,&27,&27,&27,&27,&27,&27 
210 DATA &27,&07,&41 

220 POKE ADDR + 19, LADDR !LAST 2 BYTES POINT BACK 

230 POKE ADDR + 20, HADDR !TO TOP OF DISPLAY LIST 

240 POKE LMSLO, LCADDR:POKE LMSHI, HCADDR 1TELLS SCREEN RAM START 

250 K = -1 ! 250 - 320 LOAD DATA INTO 

260 FOR 1=1 TO 300 ! SCREEN RAM AREA, A PAGE FULL 

270 K = K + 1 :POKE CADDR + K,33 !OF A's AND THEN THE ALPHABET 
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280 NEXT I 

290 FOR I = 34 TO 58 

300 FOR J=1 TO 20 

310 K = K + 1 :POKE CADDR+KJ 

320 NEXT J,l 

330 POKE &22F,0 !TURN OFF ANTIC 

340 POKE &230,LADDR ITELL IT WHERE MY DISPLAY 

350 POKE &231,HADDR ! LIST IS, AND ... 

360 POKE &22F.&22 ITURN ANTIC BACK ON 

370 REM HERE IS THE REAL PROGRAM 

380 FOR 1 = 1 TO 15 1380 - 410 DO THE VERTICAL 

390 POKE VSCROL.I IFINE SCROLL 

400 FOR W = 1 TO 30:NEXT W 

410 NEXT I 

420 CADDR = CADDR + 20 ICALCULATE WHERE NEXT LINE OF 
430 LCADDR = CADDR AND &FF ISCREEN RAM STARTS 

440 HCADDR = ((CADDR AND &FF00)/256) AND &FF IFOR THE COARSE SCROLL 
450 WAIT &D40B,&FF,96 IWAIT UNTIL TV VERTICAL LINE COUNTER HITS 96 
460 POKE VSCROL,0 ITHEN SET CHARACTERS BACK TO ORIGINAL POSITION 
470 POKE LMSLO, LCADDR IAND COARSE 

480 POKE LMSHI, HCADDR ISCROLL BY CHANGING LMS BYTE IN DISPLAY LIST 
490 GOTO 380 
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APPENDIX B 



GRAPHICS MODES PROGRAMS 



MICROBE INVASION EXAMPLE 

10 REM MICROBE INVASION 

15 REM SPIRAL CREATURES TAKE OVER SCREEN 

16 REM 10 PERCENT CHANCE SCREEN CHANGES MODE 

17 REM WHEN CREATURE GOES OUT OF BOUNDS 
30 RANDOMIZE 

40 MODE = RND(8) 

50 GRAPHICS MODE + 16 
60 PIX = RND(1 5) 

70 SETCOLOR 0,PIX,6 
80 COLOR 1 
90 BAK = RND(255) 

100 POKE 71 2, BAK 

110 X = RND(1 50): Y = RND(100) 

120 IF X >140 THEN 40 
130 Z = 2 

140 NUM=NUM + 1 
150 FOR DOTS = 1 TO Z 
160 IF NUM = 5 THEN NUM = 1 
170 ON ERROR GOTO 230 
180 PLOT X,Y 

190 ON NUM GOSUB 250,270,290,310 
200 NEXT 
210 Z = Z-E1 
220 GOTO 140 

230 GRAPHICS MODE + 32 + 16INO TEXT WINDOW, NO SCREEN CLEAR 

240 RESUME 60 

250 X = X + 1:Y=Y + 1 

260 RETURN 

270 X = X + 1:Y=Y-1 

280 RETURN 

290 X = X-1 :Y = Y-1 

300 RETURN 

310 X = X-1:Y = Y + 1 

320 RETURN 
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The following short program makes use of RANDOMIZE and RND to print three-letter 
words and three-letter abbreviations of government agencies. 



10 RANDOMIZE ISeeds the RND function 

20 GRAPHICS 2 + 16 

30 X= RND(26) + 96 IMake first letter 

40 Y=RND(5) IMake a vowel for middle letter 

50 IF Y = 1 THEN Y = 97 IMake an A 

60 IF Y = 2 THEN Y = 101 IMake an E 

70 IF Y = 3 THEN Y = 105 IMake an I 

80 IF Y = 4 THEN Y = 111 IMake an O 

90 IF Y = 5 THEN Y = 117 IMake a U 

100 Z= RND(26) + 96 IMake last letter 

110 PRINT#6, AT(9,3);C H R$(X);C H R$(Y);C H R$(Z) 

120 FOR DELAY = 1 TO 2000:NEXT 

180 GOTO 30 
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APPENDIX C 



ALTERNATE CHARACTER SETS 



ATARI Home Computers support several standard character sets that are stored as 
part of the Operating System (OS) ROM. These include all the upper- and lowercase 
alphabet, numbers, special characters, and a special graphics character set. At times, 
however, it is very useful to be able to define your own character set. Applications for 
this capability that immediately come to mind include character-driven animation, 
foreign language word processing, and background graphics for games (for instance, a 
map or special playfield). 

ATARI Computers and ATARI Microsoft BASIC readily support this ability. This is easy 
for the ATARI Home Computer because the OS data base contains a pointer (CHBAS) 
at hex location 2F4 (decimal location 756) which points to the character set to be used. 
Normally this points at the standard character set in the OS ROM. But in BASIC, you 
can POKE your own character set into a free area of RAM (set aside with the OPTION 
CHR1 or OPTION CHR2 statement) and then reset the OS pointer, CHBAS, to point to 
your new character set. The computer will instantly begin using the new characters. 

There are several important things to keep in mind when redefining the character set: 



• Graphics mode 0 needs 128 characters defined (OPTION CHR1). Graphics 
modes 1 and 2 allow only 64 characters (OPTION CHR2). 

• All 64 or 128 characters need to be defined even though you may only wish to 
change and use one character; this is easily accomplished by transferring the 
ROM characters into your RAM area and then changing the desired character to 
its new configuration. 

• The 64-character set requires 512 bytes of memory (8 bytes per character) and 
must start on a Vi K boundary. The 128-character set requires 1024 bytes of 
memory and must start on a IK boundary. The programmer need not worry 
about these restrictions when using the CHR1 and CHR2 options; the area is 
allocated to begin on the proper boundary. 

• The value that is poked into CHBAS after the character set is defined is the page 
number in memory where the character set begins. This value can be computed 
with the following statement: 

CHBAS% = (VARPTR(CHRn)/256) AND &FF 

Where "n" is either 1 or 2. This value is then poked into location &2F4 
(decimal 756). 
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The most time-consuming process in using an alternate character set is creating the 
characters. Each character consists of 8 bytes of memory, stacked one on top of the 
other (see Figure C-1). Visualize each character as an 8x8 square of graph paper. 
Darken the necessary square on the graph paper to create a character (see Figure C-2). 
Then, each row of the 8x8 square is converted from this binary representation (where 
each darkened square is a 1 and each blank square is a zero) to a hex or decimal 
number (see Figure C-2). These numbers are then poked into the appropriate bytes of 
the RAM area, from top to bottom in these figures, to define the character in RAM. The 
first 8 bytes of the reserved (OPTION CHR1 or CHR2) area define the zeroth character; 
the next 8 bytes define the first character, and so on. After transferring the standard 
character set from its ROM location to the reserved CHR1 or CHR2 area, any character 
can be redefined by finding its starting position in the area, then poking the new bytes 
into the starting byte and the next 7 bytes. After all necessary characters are redefined, 
poke the new page number into CFHBAS and the new character will immediately be ac- 
tive. Use BASIC PRINT statements to display the new characters; for instance, if you 
have redefined the " A " to be a solid block and use the statement, 

PRINT "A", 

the new character will be printed. 



A little experimentation with this process will quickly show you how powerful this 
capability can be. The program on the following page is an example of character set 
redefinition. 




Figure C-1 Amount of Memory per Character 



Byte 

No. Binary Hex Decimal 




00110000 = 


30 = 


48 


00110000 = 


30 = 


48 


11111000 = 


F8 = 


248 


00011100 = 


1C = 


28 


00001110 = 


OE = 


14 


00000111 = 


07 = 


07 


00000011 = 


03 = 


03 


00000011 = 


03 = 


03 



Figure C-2 Redefining a Character 





SAMPLE PROGRAM 



10 ! 

20 [PROGRAM TO DEMONSTRATE 
30 [ALTERNATE CHARACTER SET 
40 [DEFINITION 
50 ! 

60 !THE PROGRAM REDEFINES THE 
70 [CHARACTERS A,B,C,D,E,F,G,H 
80 ! 

90 CHBAS = &2F4 !CHR. SET POINTER 
100 OPTION CHR1 [ALLOCATE CHARACTER SET AREA 
110 ADDR% = VARPTR(CHRI) [FIND STARTING ADDRESS 
120 PAGENO% = (ADDR%/256) AND &FF [CALCULATE PACE 
130 ! 

140 MOVE 57344, ADDR%, 1024 [MOVE CHR. SET DOWN INTO RAM 
150 ! 

160 OFFSET = 33*8 [OFFSET TO "A" 

170 FOR 1 = 0 TO 63 [GET NEW CHARACTERS 
180 READ C 

190 POKE ADDR% + OFFSET + l,C [AND INSERT 
200 NEXT I 
210 ! 

220 [DATA STATEMENTS ARE BY CHARACTER 
230 ! 

240 DATA &07 / &0F,&1F,&3F,&7F,&FF,&FF,&FF 
250 DATA &E0,&F0,&F8,&FC,&FE,&FF,&FF,&FF 
260 DATA &FF,&FF,&FF,&7F,&3F,&1F,&0F,&07 
270 DATA &FF,&FF,&FF,&FE,&FC,&F8,&F0,&E0 
280 DATA &00,&00,&00,&3F,&7F,&FF,&FF,&FF 
290 DATA &00,&00,&00,&FC,&FE,&FF,&FF,&FF 
300 DATA &FF,&FF,&FF,&7F,&3F,&00,&00,&00 
310 DATA &FF,&FF,&FF,&FE,&FC,&00,&00,&00 
320 ! 

330 POKE CHBAS. PAG ENO% [SWITCH TO NEW CHARACTER SET! 
340 ! 

350 POKE &2F0,1 [TURN OFF CURSOR 
360 SETCOLOR 6,2,6 370 X = 20 
380 FOR Y = 10 TO 20 
390 WAIT &D40B,&FF,110 
400 CLS: PRINT AT... 

410 PRINT AT(X,Y + 1):"CD" 

420 FOR W = 1 TO 30. NEXT W 

430 NEXT Y 

440 CLS: PRINT AT... 

450 PRINT AT(X,22); ,/ GH ,/ 

460 SOUND 0,79,10,8,4 
470 FOR W = 1 TO 80:NEXT W 
480 FOR Y = 20 TO 10 STEP -1 
490 WAIT &D40B,&FF,110 
500 CLS: PRINT AT... 

510 PRINT AT(X,YT-1);"CD" 

520 FOR W = 1 TO 30: NEXT W 
530 NEXT Y 
540 GOTO 380 
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APPENDIX D 



DERIVED FUNCTIONS 



The following trigonometric functions can be derived by the calculations shown. 



Derived Functions 


Derived Functions in Terms of Microsoft 


Secant 


SEC(X) = 1/COS(X) 


Cosecant 


CSC(X) = 1/SIN(X) 


Inverse sine 


ARCS 1 N(X) = ATN(X/SQR(-X*X + 1 )) 


Inverse cosine 


ARCCOS(X) = -ATN(X/SQR(-X*XT- 1 ) + CONSTANT)) 


Inverse secant 


ARSEC(X) = ATN(SQR(X*X-1 )) + (SG N(X-1 )*CON- 
STANT) 


Inverse cosecant 


ARCCSC(X) = ATN(1 /SQR(X*X-1 )) 
+ (SGN(X-1 )*CONSTANT) 


Inverse contangent 


ARCCOT(X) = ATN(X) + CONSTANT 


Hyperbolic sine 


SINH(X) = (EX P(X> E X P(-X))/2 


Hyperbolic cosine 


COS H(X) = ( E X P(X) + EXP(-X))/2 


Hyperbolic tangent 


T A N H (X) = - E X P(-X)/( EXP(X) + EX P(-X)) *2 + 1 


Hyperbolic secant 


S E C H(X) = 2/( E X P(X) + E X P(-X)) 


Hyperbolic cosecant 


C S C H (X) = 2/( E X P(X> E X P(-X)) 


Hyperbolic cotangent 


COTH(X) = EXP(-X)/(EXP(X>EXP(-X))*2 + 1 


Inverse hyperbolic sine 


ARCSIN H(X) = LOG(X + SQR(X*X + 1 )) 


Inverse hyperbolic cosine 


ARCCOSH(X)+ LOG(X + SQR(X*X-1 )) 


Inverse hyperbolic tangent 


ARCTANH(X)= LOG((1 + X)/(1 -X))/2 


Inverse hyperbolic secant 


ARCSECH(X) = LOG((SQR(-X*X + 1 ) ■ + 1 )/X) 


Inverse hyperbolic cosecant 


ARCCSCH(X) = LOG((SG N(X)*SQR(X*X + 1 ) + 1 )/X) 


Inverse hyperbolic cotangent 


ARCCOTH(X) = LOG((X + 1 )/(X-1 ))/2 
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APPENDIX E 



MEMORY LOCATIONS 



Memory locations are expressed in hexadecimal, with decimal equivalents in paren- 
theses. For additional information, see the ATARI Personal Computer System Technical 
Users Notes (part number C016555). 



MEMORY MAP 



The 6502 Microprocessor is divided into four basic memory regions: RAM, cartridge 
area, I/O chip region, and resident OS ROM. Memory regions and their address boun- 
daries are listed below: 



RAM (minimum required for operation): 
RAM expansion area: 

Cartridge B (left cartridge) or 8K RAM: 
Cartridge A (right cartridge) or 8K RAM: 
Unused: 

I/O chips: 

OS floating point package: 

Resident Operating System ROM: 



0000-1 FFF (0-81 91 ) 
2000-7FFF (8192-32767) 
8000-9 FFF (3276840959) 
A000-BFFF (40960491 51 ) 
C000-CFFF (49152-53247) 
D000-D7FF (53248-55295) 
D800-DFFF (5529057343) 
E000-FFFF (57344-65535) 



RAM REGION 



The RAM region, shared by the OS and the program in control, is divided into the 
following subregions: 

• 6502 Microprocessor Page 0 Address Mode Region: 0000 through 00FF (0-255) 
allocated as follows: 

0000 through 007F (0-127): OS 

0080 through 00FF (128-255): User applications 

00D4 through 00FF (212-255): Floating point package, if used. 

• Page 1, 6502 Hardware Stack Region: 0100 through 01 FF (256-511). 

Note: At power up or the stack location points to address 01 FF (511) and 

the stack then pushes downward toward 0100 (256). The stack wraps around from 0100 
to 01 FF if a stack overflow occurs. 



• Pages 2-4, OS Data Base (working variables, tables, data buffers): 0200 through 
047 F (512-1151). 

• Pages 7-XX, User Boot Area: 0700 (1 792) to start of free RAM area, where XX is a 
function of the screen graphics mode and the amount of RAM installed. 



Note: When initial diskette startup is completed, the data base variable points to the 
next available location above software loaded. When no software is entered by the the 
initial diskette startup, the data base variable points to location 0700. 



• Screen Display List and Data: Page XX to top of RAM. Data base pointer con- 
tains address of last available location below the screen area. 
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CARTRIDGE Cartridge B is the RIGHT CARTRIDGE on the ATARI 800 Home Computer. Cartridge A 

is the LEFT CARTRIDGE on the ATARI 800 Home Computer and the only cartridge on 
the ATARI 400 Home Computer. 

• Cartridge B: 8000 through 9FFF (32768-40959) 

• Cartridge A: A000 through BFFF (40960-49151) for 8K cartridges; 8000 through 
BFFF (32768-49151) for 16K cartridges (optional) 

Note: On the ATARI 800 Home Computer, if a RAM module plugged into the last slot 
overlaps any of these cartridge addresses, the installed cartridge will disable the con- 
flicting RAM module in 8K increments. 



I/O CHIPS 



The 6502 Microprocessor performs input/output operations by addressing the follow- 
ing external support chips as memory: 



• CTIA 

• POKEY 

• PIA 

• ANTIC 



D000 through D01 F (53248-53279) 
D200 through D21 F (53760-53791) 
D300 through D31 F (5401 6-54047) 
D400 through D41 F (54272-543030) 



Some of the chip registers are read/write; others are read only or write only. Table E-2 
lists the registers and their addresses by chip. For additional information, see the 
ATARI Personal Computer System Technical Users Notes. 



RESIDENT The region from D800 through FFFF (55296-65535) permanently contains the OS and 

OS ROM the floating point package: 

• Floating point package: D800 through DFFF (55296-57343) 

• Operating System ROM: E000 through FFFF (57344-65535) 

The OS contains many vectored entry points, all fixed, at the end of the ROM and in 
RAM. The floating point package is not vectored, but all documented entry points will 
be fixed. See the Appendix of the ATARI Personal Computer System OS Users Manual 
(part of the ATARI Personal Computer System Technical Users Notes) for listings of the 
fixed ROM vectors and entry points. 



TABLE E-1 

USEFUL OS DATA BASE ADDRESSES 



Address Byte 

Hex Dec Name Size Function 



MEMORY CONFIGURATION (See Sections 4 and 7, ATARI Personal Computer System OS Users Manual ' part of 
ATARI Personal Computer System Technical Users Notes.) 



000 E 


14 


APPMHI 


2 


006A 


106 


RAMTOP 


1 


02 E4 


740 


RAMSIZ 


1 


02E5 


741 


MEMTOP 


2 


02E7 


743 


MEMLO 


2 



User-free memory screen lower limit 
Display handler top of RAM address (MSB) 
Top of RAM address (MSB) 

User-free memory high address 
User-free memory low address 
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TEXT/GRAPHICS SCREEN (See Section 5, OS Users Manual.) 



Screen Margins (text modes; text window) 



0052 


82 


LMARCN 


1 


Left screen margin (0-39; default 2) 


0053 


83 


RMARCN 


1 


Right screen margin (0-39; default 39) 


Cursor Control 








0054 


84 


ROWSCRS 


1 


Current cursor row 


0055 


85 


COLCRS 


2 


Current cursor column 


005A 


90 


OLDROW 


1 


Prior cursor row 


005 B 


91 


OLDCOL 


2 


Prior cursor column 


0290 


656 


TXTROW 


1 


Current cursor row in text window 


0291 


657 


TXTCOL 


2 


Current cursor column in text window 


02 F0 


752 


CRSINH 


1 


Cursor display inhibit flag 
(0 = cursor on, 1 = cursor off) 


Color Control 










02C0 


704 


PCOLRO 


4 


Color-luminance Player-Missile 0 


02C1 


705 


PCOLR1 


4 


Color-luminance of Player-Missile 1 


02C2 


706 


PCOLR2 


4 


Color-luminance of Player-Missile 2 


02C3 


707 


PCOLR3 


4 


Color-luminance of Player-Missile 3 


02C4 


708 


COLORO 


5 


Color-luminance of Playfield 0 


02C5 


709 


COLOR1 


5 


Color-luminance of Playfield 1 


02C6 


710 


COLOR2 


5 


Color-luminance of Playfield 2 


02C7 


711 


COLOR3 


5 


Color-luminance of Playfield 3 


02C8 


712 


COLOR4 


5 


Color-luminance of background 



Attract Mode 










004 D 


77 


ATRACT 


1 


Attract mode timer and flag 

(Value 128 = on; turns on every 9 minutes) 


Tabbing 










02A3 


675 


TABMAP 


15 


Tab stop bit map (default: 7, 15, 23, 
etc. to 119) 


Screen Memory 








0058 


88 


SAVMSC 


2 


Upper left corner of screen 



Split-Screen Memory 

0294 660 TXTMSC 2 Upper left corner of text window 
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DRAW/FILL Function 



0060 


96 


NEWROW 


1 


0061 


97 


NEWCOL 


2 


02FD 


765 


FILDAT 


1 



Internal Character Code Conversion 

02 FA 762 ATACHR 1 

Display Control Characters 

02FE 766 DSPFLG 1 

KEYBOARD (See Section 5, OS Users Manual.) 



Destination point; initialized to value in ROWCRS. 
Destination point; initialized to value in COLCRS. 
Fill data for graphics FILL command. 



Contains last ATASCII character or plot point. 



Display control character flag. 

(1 = display control characters) 



Key Reading 



02 FC 


764 


CH 


Special Functions 




0011 


17 


BRKKEY 


02 B6 


694 


INVFLG 


02 BE 


702 


SHFLOK 


02FF 


767 


SSFLAG 



1 



1 

1 

1 

1 



Contains value of last keyboard character in FIFO or 
$FF if FIFO is empty. 



IBllI key flag (normally nonzero; set to 0 by gfffllin 

Inverse video flag (norm = 0; set by Q key) 

Shift/control lock control flag ($00 = no lock (norm); 
$40 = caps lock; $80 = control lock) 

Start/stop flag (norm = 0; set by gHH 1). Set to $40 on 




CENTRAL I/O (CIO) ROUTINE (See Section 5, OS Users Manual.) 
I/O Control Block 



0340-034 F (832-847) IOCB 
0350035 F (848-863) IOCB 
0360-036 F (864-879) IOCB 
0370037F (880895) IOCB 
0380038 F (890911) IOCB 
0390039 F (912-927) IOCB 
03A003AF (928-943) IOCB 
03B003BF (944-959) IOCB 



16 


I/O Control 


Block 


16 


I/O Control 


Block 


16 


I/O Control 


Block 


16 


I/O Control 


Block 


16 


I/O Control 


Block 


16 


I/O Control 


Block 


16 


I/O Control 


Block 


16 


I/O Control 


Block 



0 

1 

2 

3 

4 

5 

6 
7 
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0340 


832 


ICHID 


1 


Handler I D. (See Section 5; Initialized to $FF at power 


0341 


833 


ICDNO 


1 


Device number 


0342 


834 


ICCMD 


1 


Command byte 


0343 


835 


ICSTA 


1 


Status 


0344 


836 


ICBAL/ICBAH 


2 


Buffer address 


0346 


838 


ICPTL/ICPTH 


2 


PUT BYTE vector (Points to CIO's "IOCB not OPEN" at 
power up and | .) 


0348 


840 


ICBLL/ICBLH 


2 


Buffer length/byte count 


034A 


842 


ICAX1/ICAX2 


2 


Auxiliary information 


034C 


844 


ICAX3/ICAX6 


4 


Spare bytes for handler use 



Zero Page IOCB 



0020 


32 


ZIOCB 


16 


Zero page IOCB (Only the first 12 bytes (lOCBs) are 
moved by the CIO utility.) 


0020 


32 


ICHIDZ 


1 


Handler index number (set to $FF on CLOSE) 


0021 


33 


ICDNOZ 


1 


Device drive number 


0022 


34 


ICCOMZ 


1 


Command byte 


0023 


35 


ICSTAZ 


1 


Status byte 


0024 


36 


ICBALZJCBALH 


2 


Buffer address 


0026 


38 


ICPTLZJCPTHZ 


2 


PUT BYTE vector (Points to CIO's "IOCB not OPEN" 
on CLOSE.) 


0028 


40 


ICBLLZJCBLHZ 


2 


Buffer length/byte count 


002 A 


42 


ICAX1ZJCAX2Z 


2 


Auxiliary information 


0002 C 


44 


ICSPRZ 


4 


CIO working variables 






(ICIDNOJCOCHR) 




CIDNO = ICSPRZ + 2; ICOCHR = ICSPRZ + 3 (See 
Sections 5 and 9 of the OS Users Manual.) 


DEVICE STATUS 








02EA 


746 


DVSTAT 


4 


Device status 


DEVICE TABLE (See Section 9, OS Users Manual.) 




031 A 


749 


HATABS 


38 


Device handler table 



SERIAL I/O (SIO) ROUTINE (See Section 9, OS Manual.) 



Device Control Block 



0300030 B (768-779) 


D C B 


12 


Device control block 


0300 


768 


DDEVIC 


1 


Device bus I D. 


0301 


769 


DUNIT 


1 


Device unit number 
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0302 


770 


DCOMND 


1 


0303 


771 


DSTATS 


1 


0304 


772 


DBUFLO,DBUFHI 


2 


0306 


774 


DTIMLO 


1 


0308 


776 


DBYTLO,DBYTHI 


2 


030A 


778 


DAUX1 ,DAUX2 


2 



Device command 
Device status 
Handler buffer address 

Device timeout (See Section 9, OS Users Manual.) 

Buffer length/byte count (See Section 9, OS Users 
Manual.) 

Auxiliary information 



BUS SOUND CONTROL 

0041 65 SOUNDR 1 Quiet/noisy I/O flag (0 = quiet) 



ATARI CONTROLLERS (See Appendix L, OS Users Manual.) 



Joysticks 



0278 632 

0284 644 



STICK0-STICK3 4 
STRIG0-STRIG3 4 



Joystick position port 
Joystick trigger port 



Paddles 

0270 624 

027C 636 



PADDL0-PADDL7 8 
PTRIG0-PTRIG7 8 



Paddle position port 
Paddle trigger port 



Light Pen 



0234 


564 


LPENH 


1 


Light pen horizontal position code 


0235 


565 


LPENV 


1 


Light pen vertical position code 


0278 


632 


STICK0-STICK3 


4 


Light pen button port 



FLOATING POINT PACKAGE (See Section 8, OS Users Manual.) 



00D4 


212 


FRO 


6 


Floating point register 0 


00E0 


224 


FR1 


6 


Floating point register 1 


00F2 


242 


CIX 


1 


Character index 


00 F3 


243 


INBUFF 


1 


Input text buffer pointer 


00FB 


251 


DEGFLG/RADFLG 


1 


Degrees/radians flag (0 = DEGFLG; 6 = 
DEGFLC = 0) 


00 FC 


252 


FLPTR 


2 


Pointer to floating point number 


0580 


1408 


LBUFF 


96 


Text buffer 



degrees; 
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POWER UP AND 



(See Section 7, OS Users Manual.) 




Diskette/Cassette Boot 

0002 2 CASINI 

000C 12 DOSINI 



2 Cassette boot initialization vector 

2 Diskette boot initialization vector 



Environment Control 

0008 8 WARMST 1 Warmstart flag(= 0 on power up; $FF on 

000A 10 DOSVEC 2 Noncartridge control vector 

(See Section 10, OS Users Manual.) 



INTERRUPTS (See Secton 6, OS Users Manual.) 



0010 


16 


POKMSK 


1 


POKEY interrupt mask 


0042 


66 


CRITIC 


1 


Critical code section flag 

(nonzero = executing code is critical) 


Real Time Clock 








0012 


18 


RTCLOK 


3 


Real time frame counter (1/60 sec) 

( + 0 = MSB; +1 = NSB; +2 = LSB) 


System VBFANK Timers 








0218 


536 


CDTMV1 


2 


System timer 1 value 


021 A 


538 


CDTMV2 


2 


System timer 2 value 


021 C 


540 


CDTMV3 


2 


System timer 3 value 


021 E 


542 


CDTMV4 


2 


System timer 4 value 


0020 


544 


CDTMV5 


2 


System timer 5 value 


0226 


550 


CDTMA1 


2 


System timer 1 jump address 


0228 


552 


CDTMA2 


2 


System timer 2 jump address 


022A 


554 


CDTMF3 


2 


System timer 3 flag 


022C 


556 


CDTMF4 


1 


System timer 4 flag 


022 E 


558 


CDTMF5 


2 


System timer 5 flag 


NMI 


Interrupt Vectors 








0200 


512 


VDSLST 


2 


Display list interrupt vector 
(not used by the OS) 


0222 


546 


VVBLKI 


2 


Immediate VBLANK vector 


0224 


548 


VVBLKD 


2 


Deferred VBLANK vector 



r i 
L J 
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IRQ Interrupt Vectors 



0202 


514 


VPRCED 


2 


0204 


516 


VINTER 


2 


0206 


518 


VBREAK 


2 


0208 


520 


VKEYBD 


2 


020A 


522 


VUSERIN 


2 


020C 


524 


VSEROR 


2 


020E 


526 


VSEROC 


2 


0210 


528 


VTIMR1 


2 


0212 


530 


VTIMR2 


2 


0214 


532 


VTIMR4 


2 


0216 


534 


VIMIRQ 


2 



Hardware Register Updates 



0230 


560 


SDLSTL 


1 


0231 


561 


SDLSTH 


1 


02 CO 


704 


PCOLRx 


4 


02C4 


708 


PCOLORx 


5 


02 F3 


755 


CHACT 


1 


02 F4 


756 


CHBAS 


1 



Serial I/O bus proceed signal 
Serial I/O bus interrupt signal 
BREAK instruction vector 
Keyboard interrupt vector 
Serial I/O bus receive data ready 
Serial I/O bus transmit ready 
Serial I/O bus transmit complete 
POKEY timer vector (not used by OS) 
POKEY timer vector (not used by OS) 
POKEY timer vector (not used by OS) 
General IRQ vector 



Screen display list address 

Screen display list address 

Color register 

Color register 

Character control 

Character address base register 

($E0 = uppercase, number set; $E2 = lowercase, special 
graphics set; default = $EO) 



USER AREAS (See Section 4, OS Users Manual.) 

Note: The following areas are available to the user in a nonnested environment. 



0080 128 128 

0480 1 1 52 640 
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Note: For additional information refer to the ATARI Personal Computer System Hardware Manual (part of the ATARI 
Personal Computer System Technical Notes). 



TABLE E-2 

HARDWARE ADDRESSES 



Address 




Register 




OS 


Shadow 




Hex 


Dec 


Name 


Function 


Hex 


Dec 


Name 


ANTIC CHIP 












D400 


54272 


DMACTL 


Direct memory access (DMA) 
control (WRITE) 


22 F 


559 


SDMCTL 


D401 


54273 


CHACTL 


Character control (WRITE) 


2F3 


755 


CHART 


D402 


54274 


DLISTL 


Display list pointer 
low byte (WRITE) 


230 


560 


SDLSTL 


D403 


54275 


DLISTH 


Display list pointer 
high byte (WRITE) 


231 


561 


SDLSTH 


D404 


54276 


HSCROL 


Horizontal scroll (WRITE) 








D405 


54277 


VSCROL 


Vertical scroll (WRITE) 








D407 


54279 


PMBASE 


Player-missile base address 
(WRITE) 








D409 


54281 


CHBASE 


Character base address 
(WRITE) 


2F4 


756 


CHBAS 


D40A 


54282 


WSYNC 


Wait for horizontal sync 
(WRITE) 








D40B 


54283 


VCOUNT 


Vertical line counter (READ) 








D40E 


54286 


NMIEN 


Nonmaskable interrupt (NMI) 
enable (WRITE) 








D40F 


54287 


NMIRES 


Reset NMIST (WRITE) 








D40F 


54287 


NMIST 


NMI status (READ) 









D41CFD4FF (54288-54527) Repeat ANTIC addresses D400 through D40F. 

CTIA CHIP 

PLAYER-MISSILE GRAPHICS CONTROL 



Horizontal Position Control (WRITE) 



D000 


53248 


HPOSPO 


Horizontal 


position 


Player 0 


D001 


53249 


HPOSPI 


Horizontal 


position 


Player 1 


D002 


53250 


HPOSP2 


Horizontal 


position 


Player 2 


D003 


53251 


HPOSP3 


Horizontal 


position 


Player 3 


D004 


53252 


HPOSMO 


Horizontal 


position 


Missile 0 


D005 


53253 


HPOSM1 


Horizontal 


position 


Missile 1 


D006 


53254 


HPOSM2 


Horizontal 


position 


Missile 2 


D007 


53255 


HPOSM3 


Horizontal 


position 


Missile 3 
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Collision Control (READ) 



D000 


53248 


MOPF 


D001 


53249 


Ml PF 


D002 


53250 


M2PF 


D003 


53251 


M3PF 


D004 


53252 


POPF 


D005 


53253 


PI PF 


D006 


53254 


P2PF 


D00 7 


53255 


P3PF 


D008 


53256 


MOPF 


D009 


53257 


Ml PL 


DOOA 


53258 


M2PL 


DOOB 


53259 


M3 PL 


DOOC 


53260 


POPL 


DOOD 


53261 


PI PL 


DOOE 


53262 


P2PL 


DOOF 


53263 


P3PL 


Collision Clear 


(WRITE) 


D01E 


53278 


HITCLR 


Size Control (WRITE) 


Note: 0 


= normal, 1 = double 


D008 


53256 


SIZEPO 


D009 


53257 


SIZEP1 


DOOA 


53258 


SIZEP2 


DOOB 


53259 


SIZEP3 


DOOC 


53260 


SIZEM 


Graphics Registers (WRITE) 


DOOD 


53261 


GRAFPO 


DOOE 


53262 


GRAFP1 


DOOF 


53263 


GRAFP2 


D010 


53264 


GRAFP3 


D011 


53265 


GRAFM 



Missile 0 to playfield 
Missile 1 to playfield 
Missile 2 to playfield 
Missile 3 to playfield 
Player 0 to playfield 
Player 1 to playfield 
Player 2 to playfield 
Player 3 to playfield 
Missile 0 to player 
Missile 1 to player 
Missile 2 to player 
Missile 3 to player 
Player 0 to player 
Player 1 to player 
Player 2 to player 
Player 3 to player 



Collision clear 



quadruple size. 

Size of Player 0 
Size of Player 1 
Size of Player 2 
Size of Player 3 
Sizes of all missiles 



Graphics 

Graphics 

Graphics 

Graphics 

Graphics 



for Player 0 
for Player 1 
for Player 2 
for Player 3 
for all missiles 
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Joystick Controller Triggers (READ) 



D010 


53264 


TRIGO 


Read Joystick 0 trigger 


284 


644 


STRIGO 


D011 


53265 


TRIG1 


Read Joystick 1 trigger 


285 


645 


STRIG1 


D01 2 


53266 


TRIG2 


Read Joystick 2 trigger 


286 


646 


STRIG2 


D01 3 


53267 


TRIG3 


Read Joystick 3 trigger 


287 


647 


STRIG3 



Color-Luminance Control (WRITE) 
D012 53266 COLPMO 


Color-lum. 


Player-Missile 0 


2C0 


704 


COLRO 


D01 3 


53267 


COLPM1 


Color-lum. 


Player-Missile 1 


2 Cl 


705 


PCOLR1 


D014 


53268 


COLPM2 


Color-lum. 


Player-Missile 2 


2C2 


706 


PCOLR2 


D01 5 


53269 


COLPM3 


Color-lum. 


Player-Missile 3 


2C3 


707 


PCOLR3 


D016 


53270 


COLPFO 


Color-lum. 


Playfield 0 


2C4 


708 


COLORO 


D017 


53271 


COLPF1 


Color-lum. 


Playfield 1 


2C5 


709 


COLOR1 


D018 


53272 


COLPF2 


Color-lum. 


Playfield 2 


2C6 


710 


COLOR2 


D019 


53273 


COLPF3 


Color-lum. 


Playfield 3 


2C7 


711 


COLOR3 


D01 A 


53274 


COLBK 


Color-lum. 


background 


2C8 


712 


COLOR4 



Priority Control (WRITE) 
D01B 53275 PRIOR 


Priority selection 


26F 


623 


GPRIOR 


Graphics Control (WRITE) 
D01D 53277 GRACTL 


Graphics control 









MISCELLANEOUS I/O FUNCTIONS 

PAL/NTSC Systems 

D014 53268 PAL Read PAL/NTSC bits 



Console Switches (set to 8 during VBLANK) 



D01F 53279 CONSOL 

D01F 53279 CONSOL 



Write console switch port 
Read console switch port 
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POKEY CHIP 



Audio (WRITE) 



D200 


53760 


AUDF1 


Audio Channel 1 frequency 








D201 


53761 


AUDC1 


Audio Channel 1 control 








D202 


53762 


AUDF2 


Audio Channel 2 frequency 








D203 


53763 


AUDC2 


Audio Channel 2 control 








D204 


53764 


AUDF3 


Audio Channel 3 frequency 








D205 


53765 


AUDC3 


Audio Channel 3 control 








D206 


53765 


AUDF4 


Audio Channel 4 frequency 








D207 


53767 


AUDC4 


Audio Channel 4 control 








D208 


53768 


AUDCTL 


Audio control 








Start Timer (WRITE) 










D209 


53769 


STIMER 


Resets audio-frequency 
dividers to AUDF values 








Pot Scan (Paddle Controllers) 










D200 


53760 


POT 0 


Read Pot 0 


270 


624 


PADDL0 


D201 


53761 


POT 1 


Read Pot 1 


271 


625 


PADDL1 


D202 


53762 


POT 2 


Read Pot 2 


272 


626 


PADDL2 


D203 


53763 


POT 3 


Read Pot 3 


273 


627 


PADDL3 


D204 


53764 


POT 4 


Read Pot 4 


274 


628 


PADDL4 


D205 


53765 


POT 5 


Read Pot 5 


275 


629 


PADDL5 


D206 


53766 


POT 6 


Read Pot 6 


276 


630 


PADDL6 


D207 


53767 


POT 7 


Read Pot 7 


277 


631 


PADDL7 


D208 


53768 


ALLPOT 


Read 8-line pot-port state 








D20B 


53771 


POTGO 


Start pot scan sequence 
(written during VBLANK) 








Keyboard Scan and Control (READ) 










D209 


53769 


KBCODE 


Keyboard code 


2FC 


764 


CH 



Random Number Generator (READ) 

D20A 53770 RANDOM Random number generator 
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Serial Port 



D20A 


53770 


SKRES 


SKSTAT reset (WRITE) 




D20D 


53773 


SERIN 


Serial port input (READ) 




D20D 


53773 


SEROUT 


Serial port output (WRITE) 




D20F 


53775 


SKCTLS 


Serial Port 4-keyboard 
control (WRITE) 


232 562 SSKCTL 


D20F 


53775 


SKSTAT 


Serial Port 4-keyboard 
status register (READ) 





IRQ Interrupt 
D20E 532774 


IRQEN 


IRQ interrupt enable (WRITE) 


10 


16 


POKMSK 


D20E 532775 


IRQST 


IRQ interrupt status (READ) 









D210-D2FF (53776-5401 5) Repeat D200-D20F (53760-53775) 



PIA CHIP 



Joystick Read/Write Registers 



D300 54016 PORTA 



D301 54017 PORTB 



D302 54018 PACTL 

D303 54019 PBCTL 



Writes or reads data from 
Controller Jacks 1 and 2 
if bit 2 of PACTL = 1. 

Writes to direction control register if 
bit 2 of PACTL = 0. 

Writes or reads data from 
Controller Jacks 3 and 4 
if bit 2 of PBCTL = 1. 

Writes to direction 
control register if 
bit 2 of PBCTL = 0. 

Port A control (set to $3C 
by IRQ code). 

Port B control (set to $3C 
by IRQ code). 



D304-D3FF (54020-54271) Repeat D300-D303 (54016-54019) 



278 632 STICK0 

279 633 STICK1 



27A 634 STICK2 

27B 635 STICK3 
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APPENDIX F 



PROGRAM CONVERSIONS 



COPYRIGHT NOTICE 

Computer programs are protected in general by the Copyright Law. While the 
Copyright Law expressly permits the owner of the copyright for a computer program to 
adapt the program as necessary for utilization on a machine, such adaptation or 
translation is otherwise generally prohibited. ATARI recommends that you only con- 
vert programs purchased from the copyright owner or in accordance with a software 
license. 



CONVERTING 
PROGRAMS TO 
ATARI 

MICROSOFT 

BASIC 



The COMMODORE PET*® BASIC, APPLE**® APPLESOFT**® BASIC, and RADIO 
SHACK***® LEVEL II BASIC were all written by Microsoft. The overall approach and 
syntax of these BASIC languages has been kept compatible whenever possible to allow 
both programs and programmers to easily move from machine to machine. This ap- 
pendix reviews the differences and indicates how to work around them when convert- 
ing to ATARI Microsoft BASIC. 



Microsoft divided its original BASIC into several different levels: 4K, 8K, Extended, and 
Full. Each successive level was a superset of the previous level and required more 
memory. When a manufacturer requested BASIC, the specific level to start from was 
determined by the memory constraints of the target machine. One source of incom- 
patibility is due to starting at different levels. PET BASIC and APPLE APPLESOFT 
BASIC are based on the 8K level. RADIO SHACK LEVEL II and ATARI Microsoft 
BASIC are based on the full language level. Fortunately, this makes conversion into 
ATARI Microsoft BASIC easy. The key language differences between 8K and Full 
BASIC are the following: 



• DATA TYPES: In 8K BASIC, double precision is not supported. Only 9 digits of 
accuracy are available. Integers can be used but they are converted to single 
precision before any arithmetic is done, so their only advantage is small storage 
requirements — not speed. 

• PRINT USING is not available, so the user has to format his own numbers. 

• The advanced statements: IF. ..THEN. ..ELSE, DEFINT, DEFSNG, DEFDBL, 
DEFSTR, TRON, TROFF, RESUME, and LINE INPUT are not supported. 

• The functions, INSTR and STRINGS, are not supported. 

• Arrays can only be single dimensioned. 

• User-defined functions can only have one argument. 

By far the most difficult areas for conversion are machine-dependent features such as 
graphics and machine language use. In all programming it is important to isolate the 
uses of the features and document the assumption made about the machine. 

*PET is a registered trademark of Commodore Business Machines, Inc. 

**APPLE and APPLESOFT are registered trademarks of APPLE COMPUTER. 

***RADIO SEIACK is a registered trademark of TANDY CORPORATION. 
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APPENDIX G 



CONVERSION FROM COMMODORE (PET) 

BASIC VERSION 4.0 



Most of the difficulty in converting from Commodore (PET) BASIC (used on Com- 
modore PET computers) comes from specific hardware features rather than the BASIC 
language since it is a strict implementation of the 8K level. Some of the conversion 
problems are: 

• The Commodore PET character set has been extended to 256 characters. These 
characters are block graphics characters. In order to emulate this feature of the 
Commodore PET, an ATARI Computer user should set up a RAM-based 
character set. 

• Commodore PET BASIC has built-in constants as follows: Tl$ (TIME$ for ATARI 
Computers) and Tl (TIME for ATARI Computers), ST for the STATUS of the last 
I/O operation and a pi symbol for the constant pi. 

• Commodore PET I/O is done with special statements that control its IEEE bus. 
The arguments to OPEN are completely different from other machines and 
must be completely changed. The exact format of sending the characters is 
done by specifying a channel number with PRINT and INPUT statements, which 
is the same as ATARI Microsoft BASIC, so only the OPEN and control 
statements need to be reprogrammed. 

• The display size of the Commodore PET is 40 by 25. If menus are designed for 
this layout, they will need to be reprogrammed. 

• PEEKs and POKEs are always very machine dependent. Commodore PET pro- 
grams often use PEEK and POKE to control cursor positioning because there is 
no direct way to change the cursor position. Each PEEK and POKE must be ex- 
amined and reprogrammed. 

• Commodore PET programs often embed cursor control characters in literal text 
strings. The ATARI Microsoft BASIC also supports this feature but the character 
codes are different and must be changed. 

• The Commodore PET calls CLEAR, CLR. 

• Any use of machine language through the Commodore PET EXEC statement will 
have to be carefully examined because although the microprocessor is the 
same, the layout of memory and the way of passing arguments to BASIC and 
receiving them from BASIC are quite different. 

• Since the Commodore PET does not support sound or true graphics there is no 
conversion problem in these areas. 

• RND is different. RND with a positive argument (generally 1) returns a number 
between 0 and 1 . 

Overall, if a special character set is set up identical to the Commodore PET's, it should 
be quite easy to convert programs that do not make heavy use of machine language or 
PEEK and POKE. 
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CONVERSION TO ATARI MICROSOFT BASIC 



Use the following table to convert a software program developed under Commodore 
(PET) BASIC 4.0. 

Note: For simplicity, those universal BASIC commands such as RUN, CONT, and POKE 
have been omitted. In those cases, no conversion is necessary. 

The following table can also be used to perform diskette-based functions. Commodore 
(PET) BASIC 4.0 is a diskette-based language that must be supported by the ATARI 
ComputerDOS options. 

(Also see Appendix A.) 



COMMODORE (PET) Equivalent ATARI Computer ATARI 

COMMAND DOS OPTION Microsoft 

BASIC 



DIRECTORY 



COPY 



RENAME 



SCRATCH 



HEADER 



BACKUP DO TO D1 



DIRECTORY- SEARCH SPEC, LIST FILE? 



COPY — FROM, TO? 
D1:fn,D2:fn 



RENAME, GIVE OLD NAME, NEW 
D2 :old in, new in H 

D UUj £ . 

DELETE FILESPEC 
D2:fn jj|| JJj 

TYPE "Y" TO DELETE in 



I 



RETURN 



WHICH DRIVE TO FORMAT? 



NAME 



KILL 



i ao 

TYPE "Y" TO FORMAT DRIVE 1 

Y 



J 

DUP DISK — SOURCE, DEST DRIVES? 

V ED 



TYPE "Y" IF OK TO USE PROGRAM AREA? 

y Mmmm 

INSERT SOURCE DISK, TYPE RETURN 



INSERT DESTINATION DISK, TYPE RETURN 
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Keep in mind that the Commodore (PET) BASIC 4.0 is a diskette-supported language. 
Therefore, when converting to run the Commodore (PET) program on your ATARI 
Computer, you must be aware of the peripherals involved. 



DLOAD 


LOAD "Dn.filename 


LOAD 


CLOAD 


DCLOSE 


CLOSE filenumber 


DOPEN 


OPEN filenumber 


DSAVE 


SAVE filename 


SAVE 


CSAVE 



Some of the Commodore (PET) BASIC 4.0 commands cannot be easily supported. As 
an example, use the following conversion: 

APPEND# OPEN #1, "filespec" INPUT 

OPEN #2, "filespec" OUTPUT 
LINE INPUT#1, A$ 

PRINT #2, A$ 

CLOSE #1 
KILL " filename " 

INPUT "filename";N$ 

LINE INPUT " ";A$ 

LINE INPUT" ";B$ 

PRINT#2, N$ 

PRINT#2, A$ 

PRINT#2, B$ 

CLOSE 

NAME "filename2" AS " filename " 



Check the logical flow of the software that you wish to convert to determine the direc- 
tion of these commands. You will have to program around their use, depending upon 
the results you wish to accomplish with your software application. 
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APPENDIX H 



CONVERTING RADIO SHACK 

TRS-80 PROGRAMS TO 
ATARI MICROSOFT BASIC 



Radio Shack BASIC is based on Full Microsoft BASIC, so converted programs will 
make much better use of the features of ATARI Microsoft BASIC than APPLE or Com- 
modore PET programs. ATARI Microsoft BASIC does have some additional features, 
such as COMMON, because it was written later and because the memory limitation 
for storing BASIC itself is not as restrictive on the ATARI Computer as it is on the Radio 
Shack Computer. The term Radio Shack BASIC refers to the BASIC built into the 
Model I and Model III computers, and called "Level II" BASIC. The BASIC on the 
Model II is very similar, but it is not specifically covered here. 

• The Radio Shack display size poses the greatest problem in converting TRS-80 
BASIC programs, because it is 16 by 64. Programs that use the full 64 characters 
for tables or menus will need to be changed. 

• Radio Shack supports a form of graphics that allow black and white displays of 
128 by 48 pixels intermixed with characters. The only statements for manipula- 
tion of the graphics are: CLS (clear screen), SET (turn a point on), RESET (turn a 
point off), and POINT (test the value of a point on the screen). 

• Radio Shack does not store the up-arrow character in the standard ASCII posi- 
tion, so it has to be translated when moving programs onto the ATARI Com- 
puter. 

• Radio Shack PRINTER I/O is done with LPRINT and LLIST without opening a 
device. Radio Shack cassette I/O is done with PRINT or INPUT to channels 1 
and 2 (two drives can be supported). The format of files on cassette is complete- 
ly different. 

• Calls to machine language are done with USR. Because Radio Shack Computers 
use the Z-80 processor instead of the 6502, machine language routines will have 
to be completely rewritten. 

• PEEKs and POKEs cannot be directly converted. PEEK and POKE are not heavi- 
ly used on the Radio Shack Computers. 

• The cursor positioning syntax is an @ after PRINT in Radio Shack BASIC and 
"AT" in ATARI Microsoft BASIC. 

• The error codes returned by ERR are completely different. 
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TRS-80 



ATARI 



DEFINITION 



AUTO mm-nn 


AUTO mm,nn 


Generates line numbers automati- 
cally. 


CDBL(exp) 


— 


Returns double-precision represen- 
tation of expression. 


CINT(exp) 


— 


Returns largest integer not greater 
than the expression. 


CLOAD 


CLOAD 

LOAD"C:" 


Loads a BASIC program from 
tape. 


CLOAD? 


VERIFY"C:filespec" 


Verifies BASIC program on tape to 
one in memory. 


CSNG(X) 


Automatically truncates 


Returns single-precision representa- 
tion of the expression. 


EDIT In 


AUTO line number 


Lets you edit specified line number. 
Use cursor control keys. 


FIX(x) 


SG N(X)* 1 NT( A BS(X)) 


Truncates all digits to the right of 
the decimal point. 


INPUT#-1 


OPEN#5, "C:"INPUT 
INPUT#5 


INPUT reads data from cassette 
tape. 


LIST mm-nn 


LIST mm-nn 


Lists the program in memory onto 
the printer. 


LUST 


LIST "P:" mm-nn 


Lists program to printer. 


LPRINT 


OPEN#4, "P:" OUTPUT 
PR!NT#4, ''TEST" 


Prints a line on printer. 


MEM 


PRINT FRE (0) 




POINT (x,y) 


OPEN#5, “D" INPUT or GET#iocb, AT(s,b) 
INPUT#5, AT(sector,byte) or PUT#iocb, AT(s,b) 


PRINT @ n, list 


PRINT#6, AT(x,y);list 




PRINT 


CLOAD 


Writes data to cassette. 


RANDOM 


RANDOMIZE 





SYSTEM 



DOS 
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CONVERTING APPLESOFT PROGRAMS 

TO ATARI MICROSOFT BASIC 



Applesoft started from exactly the same BASIC source as PET BASIC, so once again 
there are very few pure language issues in converting programs to ATARI Microsoft 
BASIC. 

• Apple added two language features to Applesoft to enhance compatibility with 
their integer BASIC. They are: ONERR for error trapping and POP for eliminating 
GOSUB entries. ONERR can be easily converted to ON ERROR in ATARI 
Microsoft BASIC. POP has no equivalent since it allows a very unstructured 
form of programming where subroutines aren't really subroutines. To convert, 
add a flag, change the POP to set the flag, RETURN, and then have a statement 
at the RETURN point check the flag and clear it and branch if it is set. 

• The Apple default display size is different from the ATARI display (actual screen 
size is the same). Menus and tables laid out to use the full display will have to be 
edited. 

• The Apple disk and peripheral I/O scheme is unique. Prints to specific channels 
are used to activate plug-in peripheral cards. The prints for the cards all have to 
be reprogrammed. 

• The most difficult conversion task is changing the graphics and sound 
statements. The overall Apple high-resolution display size is 280 by 192. The co- 
lor control is fairly unusual because each pixel cannot independently take on all 
color values. The sound port is a single bit. 

• A variety of CALL statements are used in Applesoft to trigger machine-specific 
features. Use of PEEK and POKE is much rarer but also must be changed. 

• Use of machine language generally will depend on the exact memory layout of 
the Apple Computer. Since the microprocessor is the same, machine language 
can be converted when the source is available except for references to the Ap- 
ple Operating System. 

• RND is different. Apple RND with a positive argument (generally 1) returns a 
number between 0 and 1. 
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The following list of commands, statements, and functions illustrates how to convert 
Applesoft programs to ATARI Microsoft. 



APPLESOFT 



ATARI 



CALL 
Ctrl C 

DEF FN name(x) = 

HLIN 

HOME 

HPLOT 

HTAB 

INVERSE 

NORMAL 

LOAD 

NOTRACE 

ONERR GOTO n 

PDL 

POP 

RECALL 

SAVE 

TEXT 

TRACE 

VLIN 

VTAB 



USR (addr.) 

DEF name(x) = 

PLOT x,y To x,y 

CLS 

PLOT 

PRINT AT(x,y) 

ms* gj 

LOAD "D:" 

TROFF 

ON ERROR GOTO 
PEEK(address) 
add flag 
check flag 

OPEN#n, "C:" OUTPUT 
SAVE "D:" 

GRAPHICS 0 
TRON 

PLOT x,y TO x,y 
PRINT AT(x,y) 
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CONVERTING ATARI 8K BASIC 
TO ATARI MICROSOFT BASIC 



ATARI Microsoft BASIC has improved graphics capabilities. You should consider 
rewriting graphics sections to take advantage of player-missile graphics. The SET- 
COLOR registers have been changed so that registers 0, 1, 2, and 3 now refer to player- 
missiles. What was SETCOLOR 0,cc, and 11 is now SETCOLOR 4,cc, and 11. SET- 
COLOR numbers have changed so that what was 0, 1, 2, 3, and 4 for the register assign- 
ment is now 4, 5, 6, 7, and 8. Other graphics changes include a FILL instruction and a 
"chained" PLOT that replaces DRAWTO. 

Microsoft has improved string-handling capabilities. If your initial program occupies 
too much RAM you might consider compacting it by rewriting it in Microsoft. 

The are minor differences in the RND() and other instructions when converting to 
ATARI Microsoft BASIC. The RND() can be made to work identically to the 8K BASIC's 
if you include a RANDOMIZE statement as part of your program. Programs that you 
have listed in 8K BASIC onto diskette can be loaded with ATARI Microsoft BASIC, and 
with a few changes should run. 



ATARI 8K 
BASIC 


ATARI MICROSOFT 
BASIC 


ADR(s$) 


VARPTR(s$) 


CLR 


CLEAR 


DEG 


— 


DRAWTO 


PLOT x,y TO x,y 


LIST mm,nn 


LIST mm-nn 


LOCATE x,y,var 


var= SCRN$(x,y) 


LPRINT 


OPEN#7, "P:" OUTPUT 
PRINT#7, 


OPEN#iocb, 
aexpl ,aexp2, 
filespec 
filespec 
filespec 


OPEN#iocb, 
filespec INPUT 


POINT#iocb 
sector, byte 


INPUT#iocb, 

AT (sector, byte) 



COMMENTS 
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ATARI 8K 
BASIC 



ATARI MICROSOFT 
BASIC 



COMMENTS 



POP 




Use the USR function to call a machine- 
language routine. POP stack in 6502 
code. 


POSITION x,y 


PR 1 NT | #6, | AT(x,y) 




SOUND voice, 
pitch, noise, vol. 


SOUND voice, 
pitch, noise, vol., 
duration 


The duration is a new option. Dura- 
tion is given in 1/60 of a second called 
jiffies. Thus, SOUND will work the same 
as when converting programs to 
Microsoft BASIC. 


TRAP exp 


ON ERROR exp 




USR(addr,list) 


USR(addr, pointer) 


You pass only one argument to the 
ATARI Microsoft BASIC rather than an 
argument list. 


XIO 


FILL x,y TO x,y 


Microsoft's FILL plots points from x,y 
TO x,y. It scans to the right as it fills the 
area from x,y TO x,y. The sweep 
rightward stops and a new filling scan 
begins when a solid plotted line is met. 



For other XIO commands, see Appendix N. 



PADDLE, PTRIG, STICK, STRIG are done with PEEKs and POKEs in ATARI Microsoft. 
See the Section 15, "Game Controllers," for detailed description. 
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ATASCII CHARACTER SET 



DECIMAL CODE 




0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 



12 

13 

14 



15 

16 

17 

18 

19 

20 
21 
22 

23 

24 




25 

26 



HEXADECIMAL CODE 

0 

1 

2 

3 

4 

5 

6 

7 

8 
9 
A 
B 
C 
D 
E 
F 

10 

11 

12 

13 

14 

15 

16 

17 

18 
19 
1 A 



CODE CHARACTER 

□ 

D 

n 

□ 

□ 

□ 

a 



X 



E 

B 

n 

B 

B 

H 



□ 

□ 

□ 

II 

□ 

□ 

a 

□ 
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DECIMAL CODE HEXADECIMAL CODE CODE C 

27 IB 

28 1C 



29 


ID 


30 


IE 


31 


IF 


32 


20 


33 


21 


34 


22 


35 


23 


36 


24 


37 


25 


38 


26 


39 


27 


40 


28 


41 


29 


42 


2A 


43 


2B 


44 


2C 


45 


2D 


46 


2E 


47 


2F 


48 


30 


49 


31 


50 


32 


51 


33 


52 


34 


53 


35 


54 


36 


55 


37 


56 


38 


57 


39 


58 


3A 


59 


3B 


60 


3C 
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DECIMAL CODE 

61 

62 

63 

64 

65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

80 
81 
82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 



HEXADECIMAL CODE 

3D 

3E 

3F 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 
4A 
4B 
4C 
4D 
4E 
4F 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 
5A 
5B 
5C 
5D 
5E 



CODE CHARACTER 
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DECIMAL CODE 

95 

96 

97 

98 

99 
100 
101 
102 

103 

104 

105 

106 

107 

108 

109 

110 
111 
112 

113 

114 

115 

116 

117 

118 

119 

120 
121 
122 

123 

124 

125 

126 
127 



HEXADECIMAL CODE 

5F 

60 

61 

62 

63 

64 

65 

66 

67 

68 

69 
6A 
6B 
6C 
6D 
6E 
6F 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 
7A 
7B 
7C 
7D 
7E 
7F 



CODE CHARACTER 




138 
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DECIMAL CODE 



HEXADECIMAL CODE 



CODE CHARACTER 



128 


80 


129 


81 


130 


82 


131 


83 


132 


84 


133 


85 


134 


86 


135 


87 


136 


88 


137 


89 


138 


8A 


139 


8B 


140 


8C 


141 


8D 


142 


8E 


143 


8F 


144 


90 


145 


91 


146 


92 


147 


93 


148 


94 


149 


95 


150 


96 


151 


97 


152 


98 


153 


99 


154 


9A 


155 


9B 


156 


9C 


157 


9D 


158 


9E 


159 


9F 


160 


AO 
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s a 0 a b h 0 0 q a s e e □ □ e 0 m a ® ii a b a a 0 0 □ □ □ 0 □ 



DECIMAL CODE 



HEXADECIMAL CODE 



CODE CHARACTER 



161 

162 

163 

164 

165 

166 

167 

168 

169 

170 

171 

172 

173 

174 

175 

176 

177 

178 

179 

180 
181 
182 

183 

184 

185 

186 

187 

188 

189 

190 

191 

192 

193 

194 



A1 

A2 

A3 

A4 

A5 

A6 

A7 

A8 

A9 

AA 

AB 

AC 

AD 

AE 

AF 

BO 

B1 

B2 

B3 

B4 

B5 

B6 

B7 

B8 

B9 

BA 

BB 

BC 

BD 

BE 

BF 

CO 

Cl 

C2 



□ 

□ 

□ 

0 

0 

0 

0 

0 

0 

0 

0 

B 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

□ 

0 

0 

0 

0 

0 
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DECIMAL CODE 



HEXADECIMAL CODE 



CODE CHARACTER 



195 

196 

197 

198 

199 

200 
201 
202 

203 

204 

205 

206 

207 

208 

209 

210 
211 
212 

213 

214 

215 

216 

217 

218 

219 

220 
221 
222 

223 

224 

225 

226 

227 

228 



C3 

C4 

C5 

C6 

C7 

C8 

C9 

CA 

CB 

CC 

CD 

CE 

CF 

DO 

D1 

D2 

D3 

D4 

D5 

D6 

D7 

D8 

D9 

DA 

DB 

DC 

DD 

DE 

DF 

E0 

El 

E2 

E3 

E4 
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DECIMAL CODE 



HEXADECIMAL CODE 



CODE CHARACTER 



229 


E5 


230 


E6 


231 


E7 


232 


E8 


233 


E9 


234 


EA 


235 


EB 


236 


EC 


237 


ED 


238 


EE 


239 


EF 


240 


F0 


241 


FI 


242 


F2 


243 


F3 


244 


F4 


245 


F5 


246 


F6 


247 


F7 


248 


F8 


249 


F9 


250 


FA 


251 


FB 


252 


FC 


253 


FD 


254 


FE 


255 


FF 
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APPENDIX L 



RESERVED 

WORD 

ABS 

AFTER 

AND 

ASC 

AT 

ATN 

AUTO 

BASE 

CHR 

CHR$ 



ALPHABETICAL DIRECTORY 
OF BASIC RESERVED WORDS 



BRIEF SUMMARY 
OF BASIC STATEMENT 

Function returns absolute value (unsigned) of the variable 
or expression. 

Example: Y = ABS(A + B) 

Causes the placement of an entry on a time-interrupt list. 
The elapsed time to be associated with time interrupt is 
specified by the numeric expression in units of jiffies (1/60 
of a second). 

Example: AFTER (180) GOTO 1000 

Logical operator: Expression is true only if both subex- 
pressions joined by AND are true. 

Example: IF A = 10 AND B = 30 THEN END 

String function returns the numeric ATASCII value of a 
single string character. 

Example: PRINT ASC(A$) 

Use to position disk or screen output via PRINT state- 
ment. 

Example: PRINT AT(S,B);"START HERE" 

Function returns the arctangent of a number or expression 
in radians. 

Example: PRINT ATN(A) 

A command generating line numbers automatically. 
Example: AUTO 100,50 

Use with OPTION statement to set minimum value for ar- 
ray subscripts. 

Example: OPTION BASE 1 

Use with OPTION statement to allocate RAM for alter- 
nate character sets, where: CHR1 = 1024 bytes are 
allocated (128 characters), CHR2 = 512 bytes are 
allocated (64 characters), CHR0 = free the allocated 
RAM 

Example: OPTION CHR1 

String function returns a single string character equivalent 
to a numeric value between 0 and 255 in ATASCII code. 
Example: PRINT CHR$(48) 
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CLEAR 

CLEAR STACK 
CLOAD 

CLOSE 

CLS 

COLOR 

COMMON 

CONT 

COS 

CSAVE 

DATA 

DEF 



DEL 

DIM 



Use to set all strings to null and set all variables to zero. 
Example: CLEAR 

Resets all entries on the time stack to zero. 

Example: CLEAR STACK 

Use to put programs on cassette tape into computer 
memory. 

Example: CLOAD 

I/O statement used to close a file at the conclusion of I/O 
operations. 

Example: CLOSE #6 

Erases the text portion of the screen and sets the 
background color register to the indicated value, if pre- 
sent. 

Example: CLS 35 

Establishes the color register or character to be produced 
by subsequent PLOT and FILL statements. 

Example: COLOR 2 

A program statement passing variables to a chained pro- 
gram. 

Example: COMMON A,B,C$ 

Continues program execution after a or STOP. 

Example: CONT 

Function returns the cosine of the variable or expression 
(degrees or radians). 

Example: A = COS(2.3) 

Used to put programs that are in computer memory onto 
cassette tape. 

Example: CSAVE 

I/O statement lists data to be used in a READ statement. 
Example: DATA 2.3/ / PLUS ,, ,4 

Statement having two applications: 

1) Define an arithmetic or string function. 

Example: DEF SQUARE (X,Y)= SQR(X*X + Y*Y) 

2) Define default variable of type INT, SNG, DBL, or 
STR. 

Example: DEFINT l-N 

Delete program lines. 

Example: DEL 2025 

Reserves the specified amount of memory for matrix, ar- 
ray, or string array. 

Example: DIM A(3), B$(1 0,2,3) 



END 

EOF 

ERL 

ERR 

ERROR 

EXP 

FILL 

FOR...TO...STEP 

FRE(O) 

GET 

GOSUB 

GOTO 

GRAPHICS 

IF...THEN 

IF...THEN...ELSE 



Stop program, close all files, and return to BASIC com- 
mand level. 

Example: END 

Returns true (-1) if file is positioned at its end. 

Example: IF EOF(1)GOTO 300 

Error line number. 

Example: PRINT ERL 



Error code number. 

Example: IF ERR = 62 THEN END 

Generate error of code (see table). May call user ON ER- 
ROR routine or force BASIC to handle error. 

Example: ERROR 17 

Function raises the constant e to the power of expression. 
Example: B=EXP(3) 

Fills in area between two plotted points with a color. 
Example: FILL 10,10 TO 20,20 

Use with NEXT statement to repeat a sequence of pro- 
gram lines. The variable is incremented by the value of 
STEP. 

Example: FOR DAY = 1 TO 5 STEP 2 

Gives memory free space available to programmer. 
Example: PRINT FRE(0) 

Reads a byte from an input device. 

Example: GET#1,D 

Branch to a subroutine beginning at the specified line 
number. 

Example: GOSUB 210 

Branch to a specified line number. 

Example: GOTO 90 

Establishes which of the display lists and graphics modes, 
contained in the operating system are to be used to pro- 
duce the screen display. 

Example: GRAPHICS 5 

If exp is true, the THEN clause is executed. Otherwise, the 
next statement is executed. 

Example: IF ENDVAL >0 THEN GOTO 200 

If exp is true, the THEN clause is executed. Otherwise, the 
ELSE clause or next statement is executed. 

Example: IF X<Y THEN Y = X ELSE Y = A 



Appendix L 145 



INKEY$ Returns either a one-character string read from terminal 

or null string if no character pending at terminal. 
Example: A$= INKEY$ 

INPUT Read data from a device. 

Example: INPUT #1,A,B 

Read data from the keyboard. Semicolon after INPUT 
suppresses echo of carriage return/line feed. If a prompt is 
given, it will appear as written; if not, a question mark will 
appear in its place. 

Example: INPUT "VALUES"; A, B 

INSTR Returns the numeric position of the first occurrence of 

string2 in stringl scanning from position exp. 

Example: INSTR(3,X$,Y$) 

INT Evaluates the expression for the largest integer less than 

expression. 

Example: C = I NT(X + 3) 

KILL Delete a disk file. 

Example: KILL "DdNVEN.BAS" 

LEFTS Returns leftmost length characters of the string expres- 

sion. 

Example: B$= LEFT$(X$,8) 

LEN String function returns the length of the specified string in 

bytes or characters (1 byte contains 1 character). 
Example: PRINT LEN(B$) 

LET Assigns a value to a specific variable name. 

Example: LET X= 1 + 5 

LINE INPUT Read an entire line from the keyboard. Semicolon after 

LINE INPUT suppresses echo of carriage return/line feed. 
See INPUT. 

Example: LINE INPUT "NAME";N$ 

LIST Display or otherwise output the program list. 

Example: LIST 100-1000 

LOAD Load a program file. 

Example: LOAD "D:INVEN" 

LOCK Sets the file locked condition for the file named in the 

string expression. 

Example: LOCK "D1 :TEST.BAS" 

LOG Function returns the natural logarithm of a number. 

Example: D=LOG(Y-2) 

MERGE Merge program on disk with program in memory by line 

number. 

Example: MERGE "DiSUBI" 
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MID$ 

MOVE 

NAME 

NEW 

NEXT 

NOT 

NOTE 

ON ERROR 

ON...GOSUB 

ON...GOTO 

OPEN 

OPTION BASE 

OPTION CHR 
OPTION PLM 



Returns characters from the middle of the string starting 
at the position specified to the end of the string or for 
length characters. 

Example: A$ = MID$(X$,5,10) 

Moves bytes of memory from one area to another so that 
the block is not changed. 

Example: MOVE 45000,50000,6 

Change the name of a disk file. 

Example: NAME // D:SUB1 ,/ AS "SUB2" 

Delete current program and variables. 

Example: NEW 

Causes a FOR/NEXT loop to terminate or continue 
depending on the particular variables or expressions. 
Example: NEXT I 

Unary operator used in logical comparisons evaluates to 
0 if expression is non-zero; evaluates to 1 if expression is 0. 
Example: IF A=NOT B 

Causes the current disk sector number to be stored into 
the first variable and the byte number into the second 
variable for the file associated with the IOCB#. 

Example: NOTE #1,S,B 

Enables error trap subroutine beginning at specified line. 
If line — 0, disables error trapping. If line = 0 inside error 
trap routine, forces BASIC to handle error. 

Example: ON ERROR GOTO 1000 

GOSUB to statement specified by expression. (If exp = 1, 
to 20; if exp — 2 , to 20; if exp =3, to 40; otherwise, error.) 
Example: ON DATE% + 1 GOSUB 20,20,40 

Branch to statement specified by exp. (If exp = 1, to 20; if 
exp = 2, to 30; if exp = 2, to 40; otherwise, error.) 
Example: ON INDEX GOTO 20,30,40 

Open a device. Mode must be one of:INPUT, OUTPUT, 
UPDATE, and APPEND. 

Example: OPEN #1, "DdNVEN.DAT", OUTPUT 

Declare the minimum value for array subscripts; n is 0 
or 1 . 

Example: OPTION BASE 1 

Allocates space for alternate character sets. 

Example: OPTION CHR1 

Allocates space for player-missile graphics. 

Example: OPTION PLM1 
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OPTION RESERVE 



OR 



PEEK 



PLM 



PLOT 



POKE 



PRINT 



PUT 



Allocates free space for programmer's use in assembly 
language program. 

Example: OPTION RESERVE(50) 

Logical operator used between two expressions. If either 
one is true, a "1" is evaluated. A "0" results only if both 
are false. 

Example: IF A = 10 OR B = 30 THEN END 

Function returns decimal form of contents of specified 
memory location. 

Example: PRINT PEEK (&2000) 

Used with OPTION statement to allocate RAM for 
player-missile graphics, where: 

PLM1 = single-line resolution 
PLM2= double-line resolution 
PLM0= free the allocated RAM 
Example: OPTION PLM2 

Plots a single point on the screen or draws from one point 
to another. 

Example: PLOT 10,10 TO 20,20 

Insert the specified byte into the specified memory loca- 
tion. 

Example: POKE &231 0,255 

I/O command causes output from the computer to the 
specified output device. 

Example: PRINT USING "!";A$,B$ 

Write byte-oriented data to a data file. 

Example: PUT #3,4 



RANDOMIZE 



Reseed the random number generator. 
Example: RANDOMIZE 



READ 



REM 



RENUM 

RESERVE 



Read the next items in the DATA list and assign to 
specified variables. 

Example: READ l,X,A$ 

Remarks. Allows comments to be inserted in the program 
without being executed by the computer on that program 
line. Alternate forms are exclamation point (!) and 
apostrophe ('). 

Example: REM DAILY FINANCES 

Renumber program lines. 

Example: RENUM 100„100 

Used with OPTION statement to reserve a specified 
number of bytes for the programmer's use. 

Example: OPTION RESERVE (512) 



RESTORE 

RESUME 

RETURN 

RIGHTS 

RND 

RUN 

SAVE 

SCRN$ 

SETCOLOR 



Resets DATA pointer to allow DATA to be read more 
than once. 

Example: RESTORE 

Returns from ON ERROR or time-interrupt routine to 
statement that caused error. RESUME NEXT returns to 
the statement after error causing statement and RESUME 
line number returns to statement at line number. 
Example: RESUME 

T 

Return from subroutine to the statement immediately 
following the one in which GOSUB appeared. 

Example: RETURN 

Returns rightmost length characters of the string expres- 
sion. 

Example: C$ = RIGHT$(X$,8) 

Generates a random number. If parameter = 0, returns 
random between 0 and 1. If parameter >0, returns ran- 
dom number between 0 and parameter. 

Example: E = RND(10) 

Executes a program starting with the lowest line number. 

Example: RUN 

Save the program in memory with name "filename." ,A 
saves program in ASCII. ,P protects file. Also, SAVE 
"filename" LOCK encrypts the program as it writes to 
disk. 

Example: SAVE"D:PROG" 

The character or color number of the pixel at an 
x-coordinate and a y-coordinate is returned as the value 
of the function. 

Example: A=SCRN$ (23,5) 

Associates a color and luminance with a color register. 
Example: SETCOLOR 0,5,5 



SGN 1 if expression > 0 

0 if expression — 0 
-1 if expression < 0 
Example: B=SGN(X + Y) 



SIN Function returns trigonometric sine of given value in 

degrees. 

Example: B=SIN(A) 

SOUND Statement initiates one of the sound generators. 

Example: SOUND 1,121,8,10,60 
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SPC 



Use in PRINT statements to print spaces. 
Example: PRINT SPC(5),A$ 



SQR 


Function returns the square root of the specified value. 
Example: C=SQR(D) 




STACK 


Returns the number of entries available on time stack. 
Example: A = STACK 




STATUS 


Function accepts a single argument as either a numeric or 
string then returns status of logical unit number or file. 
Example: ST=STATUS(2) 




STOP 


Causes execution to stop, but does not close files. 

Example: STOP 




STR$ 


Function returns a character string equal to numeric 
value given. 

Example: PRINT STR$(35) 




STRINGS 


Returns a string composed of a specified number of 
replications of A$. 

Example: X$ = STRINGSflOO/'A") 






Returns a string 100 units long containing CFIR$(65). 
Example: Y$ = STRING$(1 00,65) 


• 


TAB 


Use in PRINT statements to tab carriage to specified posi- 
tion. 

Example: PRINT TAB(20),A$ 




TAN 


Tangent of the expression (in radians). 
Example: D = TAN(3.14) 




TIME 


Returns numeric representation of time from the real time 
clock. 

Example: ATM = TIME 




TIMES 


The time of day in a 24-hour notation is returned in the 
string. The format is FIH:MM:SS. 

Example: TIMES = "08:55:05" 

PRINT TIMES 




TROFF 


Turn trace off. 
Example: TROFF 




TRON 


Turn trace on. 
Example: TRON 




UNLOCK 


Statement terminates the LOCK condition. 
Example: UNLOCK "D1 :DATA.OUT /r 




USING 


Provides string format for printed output. 
Examples: PRINT USING "###.##"; PDOLLARS 


• 
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USR 



VAL 

VARPTR 



VERIFY 



WAIT 



XOR 



Function returns results of a machine-language sub- 
routine. 

Example: X=USR(SVBV, VARPTR(ARR(0))) 

Function returns the equivalent numeric value of a string. 
Example: PRINT VAL("3.1") 

Returns address of variable or graphics area in memory, 
or zero if variable has not been assigned a value. 

Example: l = VARPTR(X) 

Compares the program in memory with the one on 
filename. If the two programs are not found to be iden- 
tical, it returns an error. 

Example: VERIFY "D1 :DATA.OUT" 

Equality comparison, pauses execution until result equals 
third parameter. 

Example: WAIT &E456,&FF,30 

Bitwise exclusive OR (integer). 

Example: IF A XOR B = 0 THEN END 
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APPENDIX M 



ERROR CODES 



CODE 

1 



2 



3 

4 




5 



6 

7 



8 

9 

10 




11 

12 

13 



ERROR 

NEXT without FOR. NEXT was used without a matching 
FOR statement. This error may also happen if NEXT 
variable statements are reversed in a nested loop. 

Syntax. Incorrect punctuation, open parenthesis, illegal 
characters, and misspelled keywords will cause syntax 
errors. 

RETURN without GOSUB. A RETURN statement was 
placed before the matching GOSUB. 

Out of data. A READ or INPUT # statement was not given 
enough data. DATA statement may have been left out or 
all data read from a device (diskette, cassette). 

Function call error. Attempted to execute an operation 
using an illegal parameter. Examples: square root of a 
negative number, or negative LOG. 

Overflow. A number that is too large or small has resulted 
from a mathematical operation or keybord input. 

Out of memory. All available memory has been used or 
reserved. This may occur with very large matrix dimen- 
sions, nested branches such as GOTO, GOSUB, and FOR- 
NEXT loops. 

Undefined line. An attempt was made to refer or branch 
to a nonexistent line. 

Subscript out of range. A matrix element was assigned 
beyond the dimensioned range. 

Redefinition error. Attempt to dimension a matrix that 
had already been dimensioned using the DIM statement 
or defaults. 

Division by zero. Using zero in the denominator is illegal. 

Illegal direct. The use of INPUT, GET or DEF in the direct 
mode. 

Type mismatch. It is illegal to assign a string variable to a 
numeric variable and vice-versa. 
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15 


Quantity too big. String variable exceeds 255 characters 
in length. 


16 


Formula too complex. A mathematical or string operation 
was too complex. Break into shorter steps. 


17 


Can't continue. A CONT command in the direct mode 
cannot be done because program encountered an END 
statement. 


18 


Undefined user function. The USR function cannot be 
carried out. User code has an error in logic or USR start 
points to wrong memory address. 


19 


No RESUME. End of program reached in error-trapping 
mode. 


20 


RESUME without error. RESUME encountered before ON 
ERROR GOTO statement. 


21 


FOR without NEXT. NEXT statement encountered before 
a FOR statement. 


For an explanation 
Manual. 


of the following error codes, see ATARI Disk Operating System II 


128 


BREAK abort 


129 


IOCB 


130 


Nonexistent device 


131 


IOCB write only 


132 


Invalid command 


133 


Device or file not open 


134 


Bad IOCB number 


135 


IOCB read-only error 


136 


EOF 


137 


Truncated record 


138 


Device timeout 


139 


Device NAK 


140 


Serial bus 
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141 

142 

143 

144 

145 

146 

147 
160 
161 
162 

163 

164 

165 

166 

167 

168 

169 

170 

171 



Cursor out of range 

Serial bus data frame overrun error 

Serial bus data frame checksum error 

Device-done error 

Read after write-compare error 

Function not implemented 

Insufficient RAM 

Drive number error 

Too many OPEN files 

Disk full 

Unrecoverable system data I/O error 

File number mismatch 

File name error 

POINT data length error 

File locked 

Command invalid 

Directory full 

File not found 

POINT invalid 



r i 
L A 
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USE OF THE CIO 
CALLING USR ROUTINES 



There are three, prewritten USR routines provided on the ATARI Microsoft BASIC 
diskette for your use. These routines provide a flexible way to interact with the Central 
Input/Output (CIO) facilities of your ATARI Home Computer. These routines (or similar 
routines if you prefer to write your own) allow the BASIC program to send or retrieve 
data directly to or from an Input/Output Control Block (IOCB). The lOCB's are discuss- 
ed in detail in th e ATARI Operating System Users Manual (part of ATARI Personal Com- 
puter System Technical Users Notes). Refer to that document for a complete descrip- 
tion of CIO capabilities. 

These routines allow the BASIC programmer to perform such tasks as retrieving a disk 
directory, formatting a diskette, or conditioning a specific IOCB and its associated 
logical unit number to interface with RS-232 devices. Following is a brief description of 
how to read these routines into your own program and how to use them. 

STEP 1. Inserting the Routines Into a BASIC Program. 

All three routines are contained in the file CIOUSR on the ATARI Microsoft BASIC 
diskette. They are in a machine-readable format, ready to be poked directly into RAM. 
To allocate RAM for this purpose, use the OPTION RESERVE n statement where n 
should be at least 160. Get the starting address of the reserved area with the statement 
ADDR = VARPTR(RESERVE). Then, the following code can be used to put the routines 
into the BASIC program: 

OPEN #1, "D:CIOUSR" 

INPUT FOR I = 0 TO 159 
GET #1, 

POKE ADDR+ l,:NEXT I 
CLOSE #1 



STEP 2. Setting Up the Data Array 

The routines are now in the reserved area of the BASIC program. There are three 
routines called PUTIOCB, CALLCIO, and GETIOCB. PUTIOCB starts at RAM location 
ADDR. CALLCIO starts at ADDR + 61. GETIOCB starts at ADDR + 81. 

The GETIOCB routine retrieves the user-alterable bytes from a specified IOCB and 
puts them into an integer array of length 10. The programmer may alter any of these 
parameters and then put the new values back into the IOCB with the PUTIOCB 
routine. When the proper parameters have been set, the use of CALLCIO will cause the 
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IOCB values to be executed by the CIO facility. The next step is to dimension an in- 
teger array to use for retrieval and storage of the IOCB parameters. This array should 
be dimensioned to 10 using a BASE option of zero. Following is a list of the elements of 
the array and what each is used for: 



Element Number IOCB Parameter 

0 This element is the number of the IOCB to be 

used (1 to 8). 

1 COMMAND CODE 

2 STATUS — returned 

3 BUFFER ADDRESS 

4 BUFFER LENGTH 

5-10 AUX byte 1 - 6 



Each element of an integer array has two bytes of data storage, so the buffer address in 
element 3 will fit into a single integer element. 



STEP 3. Calling the USR Routines 

A USR call is used to execute the CIOUSR routines. The GETIOCB routine will return 
to the program the current values of the specified lOCB's parameters. After changing 
these parameters in the array, to effect some CIO function (i.e., setting the baud rate 
on an RS-232 port), the PUTIOCB routine is called to put the desired values into the 
specified IOCB. Then the CALLCIO routine is called to execute the CIO facility. 
Following is the syntax necessary to call each of the routines: 

nvar = USR(addr,VARPTR(array(0))) 

where: 

nvar — a numeric variable which will receive the status of the CIO function in the 
case of a CALLCIO call, otherwise it will not be specifically affected by these 
routines. 

addr — the starting address of the proper CIOUSR routine, in our current example 
these would be ADDR for PUTIOCB, ADDR + 61 for CALLCIO and ADDR + 81 for 
GETIOCB. 

array(O) — the array will be the integer array the program uses for data retrieval and 
storage for the routines. Passing the VARPTR of element zero of this array to the 
routines tells them where to begin retrieving the data from, starting with the IOCB 
number. 



Following is an example program to set up and use an RS-232 port for telecommunica- 
tions. Also see the "Disk Directory Program" in Appendix A for another example of the 
use of these routines. 



10 ! 

20 IROUTINE TO DEMONSTRATE 
30 ICIOUSR ROUTINES... 

40 ! 

50 ! PROVIDES TELECOMMUNICATIONS 
60 IWITH RS-232 DEVICES 
70 ! 

80 DIM CIO%(10),S%(10) 

90 CIO%(0) = 2 
100 S%(0)=5:S%(1) = &0D 
110 OPTION RESERVE 200 
120 ADDR = VARPTR(RE SERVE) 

130 PUTIOCB = ADDR 

140 CALLCIO = ADDR + 61 

150 GETIOCB= ADDR + 81 

160 OPEN #1 ,"D:CIOUSR" INPUT 

170 FOR 1 = 9 TO 159 

180 GET #1,D:POKE ADDR + l,D 

190 NEXT I 

200 CLOSE #1 

210 OPEN #1 ,"K:" INPUT 

220 CIO%(0)= 2 

230 CIO%(1)= 3 

240 FSPEC$ = "R:" 

250 Z = VARPTR(FSPEC$) 

260 Y = VARPTR(CIO%(3)) 

270 POKE Y,PEEK(Z + 2) 

280 POKE Y + 1,PEEK(Z + 1) 

290 Y = VARPTR(S%(3)) 

300 POKE Y,PEEK(Z + 2) 

310 POKE Y + 1 ,PEEK(Z + 1) 

320 CIO%(5) = 1 3 

330 A= USR(PUTIOCB,VARPTR(CIO%(0))) 

340 A= USR(CALLCIO,VARPTR(CIO%(0))) 

350 A= USR(GETIOCB,VARPTR(CIO%(0))) 

360 CIO%(1) = 40 

370 CIO%(5) = 0:CIO(6) = 0 

380 A= USR(PUTIOCB,VARPTR(CIO%(0))) 

390 A= USR(CALLCIO,VARPTR(CIO%(0))) 

400 X= USR(PUTIOCB,VARPTR(S%(0))) 

410 ! 

420 1SHOULD BE READY TO GO NOW 
430 PRINT "STARTING LOOP" 

440 ! 

450 GET #1 ,A:PUT #2,A:POKE 764,255 

460 X= USR(CALLCIO,VARPTR(S%(0))):IF PEEK(747) = 0 THEN 480 
470 GET #2,D:IF D<>10 THEN PRINT CHR%(D); 

480 IF PEEK(764)< > 255 THEN 450 
490 GOTO 460 
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ACTIONS TAKEN 
WHEN PROGRAM ENDS 



ACTIONS TAKEN 



Key Pressed 
or Statement 
Executed 


Close All Files 


Run Out 
the Stack 


Clear Sound 


STOP 

ERRORS 


NO 


NO 


YES 


Running off the last 
statement or "END" 


YES 


YES 


YES 


After a direct mode 
statement 


NO 


YES 


NO 


RUN 


YES 


NO 


YES 
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INDEX 



A 

ABS 55,143 
AFTER 35,143 

Alternate character set 103-105 

AND 16,143 

Apple 123,131-132 

Arithmetic symbols 16 

Array 53 

ASC 60, 143 

Asterisk 44-45 

ATASCII 135-142 

AT 48,143 

ATN 56, 143 

Audio track of cassette 41 
AUTO 21,143 



B 

BASE 143 
BASIC 1 

Blanks (see Spaces) 
Brightness (see Luminance) 



c 

Central Input/Output 157-159 
Character 

assigning color to 78 
ATASCII 135-142 
set, internal 103-105, 135-142 
Sizes in text modes 65 
CHR 143 
CHR$ 60,143 

CIO (See Central Input/Output) 
CLEAR 36,144 
Clear screen 

deferred mode 5 
direct mode 5 
CLEAR STACK 35,144 
CLOAD 24, 144 
CLOSE 50,144 
CLS 69,144 
Colon 4 
COLOR 

assigning 78 
changing 78 
default 66, 73 
registers 78, 144 
Comma 2-3, 44 
Commands 

AUTO 21,143 
CLOAD 24,144 
CSAVE 24, 144 



DEL 22,144 
DOS 20 
KILL 26,146 
LIST 20,146 
LOAD 23,146 
LOCK 26, 146 
MERGE 24, 146 
NAME. ..TO 26, 147 
NEW 19,147 
RENUM 25, 148 
RUN 19, 149 
SAVE 23,149 
SAVE... LOCK 23, 149 
TROFF 27,150 
TRON 26,150 
UNLOCK 26,150 
VERIFY 24,151 
Commodore PET 123, 125-127 
COMMON 36, 144 
Concatenation operator 59 
Constants 9 
CONT 30,144 
Controllers, 
game 89-91 
joystick 84 
keyboard 89 
paddle 89-90 
COS 56,144 
CSAVE 24, 144 
Cursor control keys 6 

D 

DATA 48, 144 

Decimal-to-hex example 97-98 
DEF 63,144 
Default 
colors 66 
disk drive 41 
tab settings 42-43 
Deferred mode 1 
DEFDBL 11 
DEFSNG 10 
DEFSTR 13 
DEL 22, 144 
Derived functions 107 
Devices 41 
Delete line 7 
DIM 53, 144 
Direct mode 1 
Disk directory program 93 
Disk drive 

default number 41 
Disk drives (D:) 41 

Display, split-screen override 65 
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Distortion 85 
Dollar sign 45 
Double-line resolution 77 
Double Precision 

double-precision real constants 10 
double-precision real variables 11 
DEFDBL 11 
DOS 20 



E 

Editing 5 
Editing, screen 6-7 
END 30,145 
End of program 

actions taken 161 
EOF 51,145 
ERL 35,145 
ERR 35, 145 
ERROR 34,145 
Error messages 153-155 
Escape key 5 
Exclamation sign 46 
EXP 56,145 
Explosion example 94 
Exponential symbol 16, 45 
Expressions 
logical 15 
numeric 15 
string 15 

F 

Fanfare music example 94-95 
FILL 68, 145 
FOR. ..TO. ..STEP 32, 145 
FRE (0) 57, 145 

Function 
arithmetic 
ABS 55, 143 
EXP 56, 145 
I NT 55,146 
LOG 56, 146 
RND 55, 149 
SGN 55, 149 
SQR 55,150 
derived 107 
special purpose 
FRE (0) 57,145 

PEEK 56,148 
POKE 57, 148 
USR 58,151 
TIME 58,150 
string 

ASC 60, 143 
CHR$ 60,143 
INKEYS 61,146 
INSTR 61,146 
LEFTS 59, 146 
LEN 60,146 
RIGHTS 60, 149 
SCRNS 62,149 
STRS 61,150 
STRINGS (N,A$) 61, 150 

STRINGS (N,M) 61, 150 

TIMES 62,150 
VAL 60,151 



trigonometric 
ATN 56, 143 
COS 56, 144 
SIN 56,149 
TAN 56,150 



Game controllers 
keyboard 89 
joystick 84, 90-91 
paddle 89-90 
GET 50, 145 
GOSUB 33,145 
GOTO 30, 145 
GRAPHICS 65,145 
Graphics 

modes 65, 69-71 
statements 
CLS 69 
COLOR 66 
FILL 68 

GRAPHICS 65,145 
PLOT 68 
SETCOLOR 67 



H 

Hexadecimal constants 13 



IF.. .THEN 31,145 
IF. ..THEN. ..ELSE 31, 145 
INKEYS 61,146 
INPUT 47, 146 
Input/output statements 
AT 48 

CLOAD 24,144 
CLOSE 50,144 
CSAVE 24,144 
DATA 48,144 
DOS 20 
EOF 51,145 
GET 50, 145 
INPUT 47,146 
LINE INPUT 47 
LOAD 23,146 
NOTE 50,147 
OPEN 49,147 
PRINT 41,148 
PRINT USING 43 
PUT 50, 148 
READ 48, 148 
RESTORE 48 
SAVE 23,149 
SPC 43 

STATUS 50,150 
TAB 42,150 

Input/Output Control Block 112, 157-158 
Input/output devices 
disk drives (D:) 41 

keyboard (K:) 41 

printer (P:) 41 

program recorder (C:) 41 

RS-232 interface (R:) 41 
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screen editor (E:) 41 

TV monitor (S:) 41 

INSTR 61,146 
INT 55, 146 
Integers 

integer constants 11 
integer variables 11-12 
DEFINT 12 
Inverse key 5 

IOCB (see Input/Output Control Block) 



j 

Joystick controller 84 



K 

Keyboard (K.) 41 

Keyboard controllers 89 
Keyboard operation 5 
Keys 

special function 
ATARI 5 
BACKSPACE 6 
BREAK 5, 7 
CAPS/LOWER 5 
CLEAR 6 
DELETE 6-7 
ESCAPE 5 
INSERT 6 
RETURN 5, 41 
SYSTEM RESET 5 
TAB 6 
editing 

CONTROL 6 
SHIFT 5,7 
cursor control 
down arrow 6 
left arrow 6 
right arrow 6 
up arrow 6 
Keywords 2 
KILL 26,146 



L 

LEFT$ 59,146 
LEN 60, 146 
LET 29,146 
Letters 

capital (uppercase) 5 
lowercase 5 
LINE INPUT 47, 146 
LIST 20,146 
LOAD 23,146 
LOCK 26, 146 
LOG 56, 146 
Logical operators 16 
Luminance 78 



M 

Mandatory # symbol 43 
MERGE 24,146 
Memory locations 109 



Microbe Invasion example 101 
Microsoft 

conversion from Apple Applesoft 123, 
131-132 

conversion from ATARI 8K BASIC 133-134 
conversion from Commodore PET 
BASIC 123,125-127 
conversion from Radio Shack Level II 
BASIC 123,129-130 
MID$ 59,147 
Minus sign 46 
Missiles 76-77 
Modes, graphics 65, 69-71 
Modes, operating 
deferred 1 
direct 5 
Modes, text 

Override split-screen 65 
MOVE 30, 75, 147 
Music example 94 

N 

NAME. ..TO 26,147 
NEW 19, 147 
NEXT 32,147 
NOT 16, 147 
NOTE 50,147 

NOTE.DAT creation program 96 
Numeric expressions 15 

o 

ON ERROR 34,147 
ON...GOSUB 34, 147 
ON. ..GOTO 33,147 
OPEN 48,147 
Operators 

arithmetic 16 
binary 16 
logical 16 
relational 15 
OPTION BASE 36, 147 
OPTION CHR 38, 147 
OPTION PLM 38, 76, 147 
OPTION RESERVE 39, 148 
Output devices 41 
OR 16,148 

P 

Paddle controllers 89-90 
Parentheses 16 
PEEK 56,89,148 
Percent sign 47 
Period 44 

Peripheral devices (see Input/output devices) 

Piano example 95-96 

Pitch 

definition 83, 86 
values 86 

Player-missile example 75, 81 
Player-missile graphics 
annotation 82-84 
collision control 80-81 
color control 78 
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diagonal movement 79 
horizontal movement 79 
mapping 77 
priority control 80 
RAM configuration 77 
size control 78 
vertical movement 79 
PLOT 68,148 
Plus sign 46 
Point-plotting modes 72 
POKE 57, 148 
Pound sign 43 
Precision 

of numeric variables 9 
Precedence of operators 15-16 
PRINT41 , 148 
Printer (P:) 41 

Printer listing 21, 41 
PRINT USING 43 
Program Recorder (C:) 41 

PUT 50, 148 

Q 

Question mark as prompt 42 
Quotation marks 2 



R 



Radio Shack 123, 129-130 
RANDOMIZE 37, 102, 148 
READ 48,148 

Relational and logical symbols 15 

Relational operators 15-16 

REM 29,148 

RENUM 25,148 

RESERVE 148 

Reserved Words 143-151 

RESTORE 48, 149 

RESUME 36, 149 

RETURN 33,149 

RIGHTS 60,149 

RND 55,102,149 

RS-232 (R:) 41,159 

RUN 19, 149 



s 

SAVE 23, 149 
SAVE... LOCK 23, 149 
Screen editor (E:) 41 

SCRN$ 62, 149 
Semicolon 3 

SETCOLOR 67, 76, 78, 149 
SGN 55, 149 
Single-line resolution 77 
Single precision 

single-precision real constants 9 
single-precision real variables 9 
DEFSNG 10 
SIN 56, 149 
SOUND 

rocket example 87 
terminating 85 



Spaces 47 
SPC 43,150 
Special function keys 
SQR 55,150 
STACK 35,150 
Statements 




5 



AFTER 35,143 
CLEAR 36, 144 
CLEAR STACK 35,144 
COMMON 36, 144 
CONT 30,144 
END 30,145 
ERL 35,145 
ERR 35, 145 
ERROR 34,145 
FOR. ..TO. ..STEP 32, 145 
GOSUB 33,145 
GOTO 30,145 
IF.. .THEN 31,145 
IF.. .THEN. ..ELSE 31, 145 
LET 29,146 
MOVE 30,147 
NEXT 32,147 
ON ERROR 34,147 
ON. ..GOSUB 34, 147 
ON. ..GOTO 33,147 
OPTION BASE 36,147 
OPTION CHR 38,147 
OPTION PLM 38,147 
OPTION RESERVE 39, 148 
RANDOMIZE 37,148 
REM 29,148 
RESUME 36,149 
RETURN 33, 149 
STACK 35,150 
STOP 30,150 
SUBROUTINES 33 
VARPTR 39,151 
WAIT 31,151 
STATUS 50,150 
STOP 30,150 
STR$ 61,150 
Strings 

concatenation operator 59 
DEFSTR 13 




string constants 12 
string expressions 16 
string functions 
ASC 60, 143 
CHR$ 60,143 
INKEY$ 61,146 
INSTR 61,146 
LEFTS 59,146 
LEN 60, 146 
MID$ 59,147 
RIGHTS 60,149 
SCRNS 62, 149 
STRS 61, 150 
STRINGS (N,AS) 61, 150 
STRINGS (N,M) 61, 150 

TIMES 62,150 
VAL 60,151 



string variables 
STRINGS (N,AS) 
STRINGS (N,M) 
Subroutine 



12 

61, 150 
61 , 1 50 




definition 33 
GOSUB 33,145 
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T 



TAB 43,150 

TAN 56,150 

Text modes 65 

TIMES 62,150 

TIME 58,150 

TROFF 27,150 

TRON 26,150 

TV monitor (S:) 41 

Typewriter graphics example 74 



U 

UNLOCK 26,150 
User-defined function 
DEF 63,144 
USING 150 
USR 58,151 



V 



VAL 60,151 
Variables 
naming 9 

VARPTR 39, 76-77, 151 
VERIFY 24,151 

Vertical fine scrolling example 98-99 
Voice 85 



w 

WAIT31 , 151 
Window 

graphics 65 
text 65 



X 

X-coordinate 68 
XOR 16,151 

Y 

Y-coordinate 68 



Z 

Zero 

as dummy variable 57 
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IMPORTANT WARRANTY INFORMATION 



LIMITED 90-DAY WARRANTY 
ON ATARI® COMPUTER CASSETTES, 

CARTRIDGES, OR DISKETTES 

ATARI, INC ("ATARI") warrants to the original consumer purchaser that this ATARI Computer Cassette, Cartridge, or Diskette ("Computer 
Media"), not including computer programs, shall be free from any defects in material or workmanship for a period of 90 days from the date 
of purchase. If any such defect is discovered within the warranty period, ATARI, at its option, will repair or replace the defective Computer 
Media. Computer Media returned for in-warranty repair/replacement must have the ATARI label still intact, must be accompanied by proof 
of date of purchase satisfactory to ATARI, and must be delivered or mailed, postage prepaid, to: 

ATARI, INC. 

Customer Service Department 
590 Brennan Street 
San Jose, CA 95131 

This warranty shall not apply if the Computer Media (i) has been misused or shows signs of excessive wear, (ii) has been damaged by being 
used with any products not supplied by ATARI, or (iii) has been damaged by being serviced or modified by anyone other than the ATARI 
Customer Service Department. 

ANY APPLICABLE IMPLIED WARRANTIES, INCLUDING WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PUR- 
POSE, ARE HEREBY LIMITED TO NINETY DAYS FROM THE DATE OF PURCHASE. CONSEQUENTIAL OR INCIDENTAL DAMAGES 
RESULTING FROM A BREACH OF ANY APPLICABLE EXPRESS OR IMPLIED WARRANTIES ARE HEREBY EXCLUDED. 

The provisions of the foregoing warranty are valid in the United States only and are subject to the laws of the State in which the Computer 
Media is purchased. Such laws may broaden the warranty protection available to the consumer purchaser of the Computer Media. 

REPAIR SERVICE: If your ATARI Computer Media requires repair other than under the 90-day Limited Warranty, please contact the ATARI 

Customer Service Department for repair/ replacement information. From California call (800) 662-6297, outside California (800) 538-7037 or 
(800) 538-7602 in Hawaii or Alaska. 

IMPORTANT: If you ship your ATARI Computer Media, package it securely and ship, charges prepaid and insured, by parcel post or 

United Parcel Service. ATARI assumes no liability for losses incurred during shipment. 

DISCLAIMER OF WARRANTY ON ATARI COMPUTER PROGRAMS: 

All ATARI computer programs are distributed on an "as is" basis without warranty of any kind. The entire risk as to the quality and perfor- 
mance of such programs is with the purchaser. Should the programs prove defective following their purchase, the purchaser and not the 
manufacturer, distributor, or retailer assumes the entire cost of all necessary servicing or repair. 

ATARI shall have no liability or responsibility to a purchaser, customer, or any other person directly or indirectly, by computer programs 
sold by ATARI. This includes, but is not limited to any interruption of service, loss of business or anticipatory profits, or consequential 
damages resulting from the use or operation of such computer programs. 
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